Storecove API Documentation

{
  "documentTypes": ["invoice"],
  "network": "peppol",
  "metaScheme": "iso6523-actorid-upis",
  "scheme": "nl:kvk",
  "identifier":"60881119"
}

{
  "documentTypes": ["invoice"],
  "network": "bpc",
  "metaScheme": "iso6523-actorid-upis",
  "scheme": "gln",
  "identifier":"1200109970580"
}

curl \
-X POST "https://api.storecove.com/api/v2/discovery/receives" \
-H "Accept: application/json" \
-H "Authorization: Bearer API_KEY_HERE" \
-H "Content-Type: application/json" \
--data @discovery.json

{
  "code":  "OK",
  "email": false
}

curl \
-X POST "https://api.storecove.com/api/v2/document_submissions" \
-H "Accept: application/json" \
-H "Authorization: Bearer API_KEY_HERE" \
-H "Content-Type: application/json" \
--data @invoice.json

{
  "guid":  "c65d43d1-4b44-40a9-8926-6743f9fc90b2"
}

curl \
-X GET "https://api.storecove.com/api/v2/document_submissions/c65d43d1-4b44-40a9-8926-6743f9fc90b2/evidence" \
-H "Accept: application/json" \
-H "Authorization: Bearer API_KEY_HERE" \
-H "Content-Type: application/json"

{
  "routing":  {
    "emails": [
      "test@example.com"
    ],
    "eIdentifiers": []
  }
}

wget --output-document=swagger-codegen-cli.jar https://repo1.maven.org/maven2/io/swagger/swagger-codegen-cli/2.4.24/swagger-codegen-cli-2.4.24.jar

java -jar swagger-codegen-cli.jar generate -i https://www.storecove.com/api/v2/openapi.json -l csharp -o csharp

java -jar swagger-codegen-cli.jar langs

{
  "legalEntityId":100000099999,
  "idempotencyGuid":"61b37456-5f9e-4d56-b63b-3b1a23fa5c73",
  "routing":{
    "eIdentifiers":[
      {
        "scheme":"NL:KVK",
        "id":"27375186"
      }
    ],
    "workflow": "full"
  },
  "attachments": [
    {
        "filename": "myname.pdf",
        "document": "JVBERi0xLjIgCjkgMCBvYmoKPDwKPj4Kc3RyZWFtCkJULyAzMiBUZiggIFlPVVIgVEVYVCBIRVJFICAgKScgRVQKZW5kc3RyZWFtCmVuZG9iago0IDAgb2JqCjw8Ci9UeXBlIC9QYWdlCi9QYXJlbnQgNSAwIFIKL0NvbnRlbnRzIDkgMCBSCj4+CmVuZG9iago1IDAgb2JqCjw8Ci9LaWRzIFs0IDAgUiBdCi9Db3VudCAxCi9UeXBlIC9QYWdlcwovTWVkaWFCb3ggWyAwIDAgMjUwIDUwIF0KPj4KZW5kb2JqCjMgMCBvYmoKPDwKL1BhZ2VzIDUgMCBSCi9UeXBlIC9DYXRhbG9nCj4+CmVuZG9iagp0cmFpbGVyCjw8Ci9Sb290IDMgMCBSCj4+CiUlRU9G",
        "mimeType": "application/pdf",
        "primaryImage": false,
        "documentId": "myId",
        "description": "A Description"
    }
  ],
  "createPrimaryImage":false,
  "document":{
    "documentType":"invoice",
    "invoice":{
      "taxSystem":"tax_line_percentages",
      "documentCurrency":"EUR",
      "invoiceNumber":"F463333333336",
      "issueDate":"2020-11-26",
      "taxPointDate":"2020-11-26",
      "dueDate":"2020-12-26",
      "invoicePeriod":"2020-11-12 - 2020-11-17",
      "references":[
        {
          "documentType":"purchase_order",
          "documentId":"buyer reference or purchase order reference is recommended",
          "lineId":"1",
          "issueDate":"2021-12-01"
        },
        {
          "documentType":"buyer_reference",
          "documentId":"buyer reference or purchase order reference is recommended"
        },
        {
          "documentType":"sales_order",
          "documentId":"R06788111"
        },
        {
          "documentType":"billing",
          "documentId":"refers to a previous invoice"
        },
        {
          "documentType":"contract",
          "documentId":"contract123"
        },
        {
          "documentType":"despatch_advice",
          "documentId":"DDT123"
        },
        {
          "documentType":"receipt",
          "documentId":"aaaaxxxx"
        },
        {
          "documentType":"originator",
          "documentId":"bbbbyyyy"
        }
      ],
      "accountingCost":"23089",
      "note":"This is the invoice note. Senders can enter free text. This may not be read by the receiver, so it is not encouraged to use this.",
      "accountingSupplierParty":{
        "party":{
          "contact":{
            "email":"sender@company.com",
            "firstName":"Jony",
            "lastName":"Ponski",
            "phone":"088-333333333"
          }
        }
      },
      "accountingCustomerParty":{
        "publicIdentifiers":[
          {
            "scheme":"NL:KVK",
            "id":"27375186"
          },
          {
            "scheme":"NL:VAT",
            "id":"NL999999999B01"
          }
        ],
        "party":{
          "companyName":"Receiver Company",
          "address":{
            "street1":"Streety 123",
            "street2":null,
            "city":"Alphen aan den Rijn",
            "zip":"2400 AA",
            "county":null,
            "country":"NL"
          },
          "contact":{
            "email":"receiver@company.com",
            "firstName":"Pon",
            "lastName":"Johnson",
            "phone":"088-444444444"
          }
        }
      },
      "delivery":{
        "deliveryPartyName":"Delivered To Name",
        "actualDeliveryDate":"2020-11-01",
        "deliveryLocation":{
          "id":"871690930000478611",
          "schemeId":"EAN",
          "address":{
            "street1":"line1",
            "street2":"line2",
            "city":"CITY",
            "zip":"3423423",
            "county":"CA",
            "country":"US"
          }
        }
      },
      "paymentTerms":{
        "note":"For payment terms, only a note is supported by Peppol currently."
      },
      "paymentMeansArray":[
        {
          "code":"credit_transfer",
          "account":"NL50RABO0162432445",
          "paymentId":"44556677"
        }
      ],
      "invoiceLines":[
        {
          "lineId":"1",
          "amountExcludingVat":2.88,
          "itemPrice":0.12332,
          "baseQuantity":2.0,
          "quantity":63.0,
          "quantityUnitCode":"KWH",
          "allowanceCharges": [
            {
                "reason": "special discount",
                "amountExcludingTax": -0.25
            },
            {
                "reason": "even more special discount",
                "amountExcludingTax": -0.75
            }
          ],
          "allowanceCharge":-1.0,
          "tax":{
            "percentage":21.0,
            "country":"NL"
          },
          "orderLineReferenceLineId":"3",
          "accountingCost":"23089",
          "name":"Supply peak",
          "description":"Supply",
          "invoicePeriod":"2020-11-12 - 2020-11-17",
          "note":"Only half the story...",
          "buyersItemIdentification":"9 008 115",
          "sellersItemIdentification":"E_DVK_PKlik_KVP_LP",
          "standardItemIdentification":"8718868597083",
          "standardItemIdentificationSchemeId":"GTIN",
          "additionalItemProperties":[
            {
              "name":"UtilityConsumptionPoint",
              "value":"871690930000222221"
            },
            {
              "name":"UtilityConsumptionPointAddress",
              "value":"VE HAZERSWOUDE-XXXXX"
            }
          ]
        }
      ],
      "allowanceCharges":[
        {
          "reason":"late payment",
          "amountExcludingTax":10.2,
          "tax":{
            "percentage":21.0,
            "country":"NL"
          }
        }
      ],
      "taxSubtotals":[
        {
          "taxableAmount":13.08,
          "taxAmount":2.75,
          "percentage":21.0,
          "country":"NL"
        }
      ],
      "amountIncludingVat":15.83,
      "prepaidAmount":1.00
    }
  }
}

{
    "event_type": "document_submission",
    "event_group": "invoice",
    "event": "succeeded",
    "details": "A textual representation of the event details, e.g. clarifications for Under Query",
    "guid": "f4624435-7fc4-4fc2-9379-dcb641d593dc",
    "idempotencyGuid": "7305ebe5-9a39-4981-9f98-c64e340f2886",
    "tenant_id": "YourTenantId"
}

{
  "event_type": "received_document",
  "event_group": "invoice",
  "event": "received",
  "receive_guid": "d9d395f8-771d-4b93-b0a5-11e9a7d7d6f5",
  "document_guid": "f4624435-7fc4-4fc2-9379-dcb641d593dc",
  "tenant_id": "YourTenantId"
}

{
  "event_type": "received_document",
  "event_group": "unknown",
  "event": "failed",
  "receive_guid": "d9d395f8-771d-4b93-b0a5-11e9a7d7d6f5",
  "document_guid": null,
  "tenant_id": "YourTenantId"
}

{
  "guid": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaa",
  "legal_entity_id": 9999999,
  "system_generated_primary_image": true,
  "document_type": "invoice",
  "sub_type": "invoice",
  "source": "peppol",
  "tax_system": "tax_line_percentages",
  "invoice_number": "201902088624",
  "issue_date": "2019-03-01",
  "tax_point_date": "2019-03-01",
  "due_date": null,
  "document_currency_code": "EUR",
  "period_start": "2021-12-01",
  "period_end": "2021-12-31",
  "note": "The invoice note. If multiple notes were received these will be concatenated.",
  "buyer_reference": "The buyer's reference. Used for internal routing by the receiver.",
  "order_reference": "deprecated, use references",
  "billing_reference": "deprecated, use references",
  "contract_document_reference": "deprecated, use references",
  "project_reference": "deprecated, use references",
  "references": [
    {
      "document_type": "purchase_order",
      "dcument_id": "used to be the order_reference"
    },
    {
      "document_type": "buyer",
      "dcument_id": "used to be the buyer_reference"
    },
    {
      "document_type": "billing",
      "dcument_id": "billing_reference"
    },
    {
      "document_type": "contract",
      "dcument_id": "contract_document_reference"
    },
    {
      "document_type": "project",
      "dcument_id": "used to be the project_reference"
    },
    {
      "document_type": "despatch_advice",
      "dcument_id": "Desptach Advice Reference"
    },
    {
      "document_type": "originator",
      "dcument_id": "Originator Document Reference"
    },
    {
      "document_type": "receipt",
      "dcument_id": "Receipt Document Reference"
    }
  ],
  "accounting_cost": "accounting cost or accounting cost code",
  "attachments": [
    {
      "document": "<base64 encoded document snip>",
      "content_type": "application/pdf",
      "primary_image": true
    }
  ],
  "sender": {
    "party_name": "Demo company",
    "legal_name": "Demo company",
    "department": null,
    "line1": "Address 1",
    "line2": null,
    "zip": "Zippy",
    "city": "Cityname",
	"building_number": "2929",
 	"secondary_number": "8181",
	"neighborhood": "حي العارض",
    "county": null,
    "country": "NL",
    "billing_contact": {
      "first_name": null,
      "last_name": null,
      "email": "info@example.com",
      "phone": "0123456789"
    },
    "identifiers": [
      {
        "superscheme": "iso6523-actorid-upis",
        "scheme": "NL:KVK",
        "scheme_numeric": "0106",
        "identifier": "999999999"
      }
	]
  },
  "payment_terms_note": "Note on the payment",
  "payment_means_array": [
    {
      "type": "CreditTransferPaymentMean",
      "account": "NL99ABNA098765432",
      "branche_code": "",
      "payment_id": "AAA333444",
      "mandate": "",
      "network": ""
    }
  ],
  "delivery": {
    "actual_date": "2021-12-31",
    "party": {
      "name": "Receiving party"
    },
    "location": {
      "id": "",
      "scheme_id": "",
      "department": "",
      "line1": "",
      "line2": "",
      "zip": "",
      "city": "",
      "building_number": "2929",
 	  "secondary_number": "8181",
	  "neighborhood": "حي العارض",
      "county": "",
      "country": ""
    }
  },
  "invoice_lines": [
    {
      "line_id": "The ID of the line",
      "name": "This invoice line",
      "description": "A description of this invoice line",
      "period_start": "2021-12-01",
      "period_end": "2021-12-31",
      "allowance_charges": [
        {
          "amount": 0.00
        }
      ],
      "price": {
        "amount": 10.25,
        "base_quantity": 1.0
      },
      "units": {
        "quantity": 1.0,
        "unit_code": "C62",
      },
      "additional_item_properites": [
        {
          "name": "Key1",
          "value": "Value1. Note that keys can be anything, to be agreed between the sender/receiver."
        },
        {
          "name": "Key2",
          "value": "Value2"
        }
      ],
      "references": [
        {
          "document_type": "purchase_order",
          "document_id": "The purchase order number",
          "line_id": "The purchase order line id",
          "issue_date": "The purchase order issue date"
        },
        {
          "document_type": "line_standard_item_identification",
          "document_id": "standard item identification",
          "document_id_scheme_id": "The scheme for the identification",
          "document_id_scheme_agency_id": "The agency that released the scheme",
          "document_id_scheme_version_id": "The version of the scheme"
        },
        {
          "document_type": "line_sellers_item_identification",
          "document_id": "Seller's item identification"
        },
        {
          "document_type": "line_buyers_item_identification",
          "document_id": "Buyers's item identification"
        },
        {
          "document_type": "item_classification_code",
          "document_id": "The item classification code",
          "document_id_list_id": "The identification scheme identifier",
          "document_id_list_agency_id": "The identification scheme issuing agency identifier",
          "document_id_list_version_id":  "The identification scheme version identifier"
        },
        {
          "document_type": "item_commodity_code",
          "document_id": "The item commodity code",
          "document_id_list_id": "The identification scheme identifier",
          "document_id_list_agency_id": "The identification scheme issuing agency identifier",
          "document_id_list_version_id":  "The identification scheme version identifier"
        },
        {
          "document_type": "line_document_reference",
          "document_id": "The document reference",
          "document_id_list_id": "The identification scheme identifier",
          "document_id_list_agency_id": "The identification scheme issuing agency identifier",
          "document_id_list_version_id":  "The identification scheme version identifier"
        },
      ],
      "amount_excluding_tax": 10.25,
      "tax": {
        "tax_amount": 0.00,
        "percentage": 0.00,
        "country": "US",
        "category": "standard",
        "type": "VAT",
        "category_code": "S",
      },
      "accounting": {
        "code": "code",
        "name": "code description",
        "list": "list of the code",
        "list_version": "list_version"
      }
    }
  ],
  "allowance_charges": [
    {
      "amount_excluding_tax": 0.00,
      "tax": {
        "tax_amount": 0.00,
        "percentage": 0.00,
        "country": "US",
        "category": "standard",
        "type": "VAT",
      },
      "reason": ""
    }
  ],
  "document_totals": {
    "total": 12.40,
    "rounding": 0.00,
    "prepaid": 0.00,
    "payable": 12.40,
  },
  "tax_subtotals": [
    {
      "amount_excluding_tax": 0.00,
      "tax": {
        "tax_amount": 0.00,
        "percentage": 0.00,
        "country": "US",
        "category": "standard",
        "type": "VAT"
      }
    }
  ]
}