Storecove

https://www.storecove.com/docs
Admin
Storecove provides a one-stop, international e-invoicing solution that helps large companies and ERP...
Tokens:53,613
Snippets:561
Trust Score:9.4
Update:2 months ago
Show doc for...
Tokens:
Raw
### V-Delivery Field Example

Source: https://www.storecove.com/docs

Example showing the v_delivery field, which indicates delivery via a local network like SDI.

```json
{
  "v_delivery": true
}
```

--------------------------------

### GET /webhook_instances/

Source: https://www.storecove.com/docs

Retrieves a WebhookInstance from the queue for processing.

```APIDOC
## GET /webhook_instances/

### Description
GET a WebhookInstance from the queue. After processing it successfully, DELETE it and GET the next one.

### Method
GET

### Endpoint
/webhook_instances/

### Response
#### Success Response (200)
- **WebhookInstance** (object) - Success
```

--------------------------------

### GET /document_submissions/{guid}/evidence/{evidence_type}

Source: https://www.storecove.com/docs

Get evidence for a DocumentSubmission by GUID with corresponding status.

```APIDOC
## GET /document_submissions/{guid}/evidence/{evidence_type}

### Description
Get evidence for a DocumentSubmission by GUID with corresponding status.

### Method
GET

### Endpoint
/document_submissions/{guid}/evidence/{evidence_type}

### Parameters
#### Path Parameters
- **guid** (string) - Required - DocumentSubmission GUID
- **evidence_type** (enum) - Optional - Type of evidence requested (default: "sending")

### Response
#### Success Response (200)
- **DocumentSubmissionEvidence** (object) - Success

#### Error Responses
- **401** - Unauthorized
- **403** - Forbidden
- **404** - Not Found
```

--------------------------------

### Configure EU Tax Percentages

Source: https://www.storecove.com/docs

Example of a standard EU tax configuration using the tax_line_percentages system.

```json
[
  {
    "country": "DE",
    "percentage": 6.0,
    "category": "standard"
  }
]
```

--------------------------------

### Configure India Tax Percentages

Source: https://www.storecove.com/docs

Example of a multi-tax configuration required for India using the tax_line_percentages system.

```json
[
  {
    "country": "IN",
    "percentage": 14.0,
    "category": "sgst"
  },
  {
    "country": "IN",
    "percentage": 14.0,
    "category": "igst"
  }
]
```

--------------------------------

### GET /purchase_invoices/{guid}/{packaging}/{package_version}

Source: https://www.storecove.com/docs/with_deprecated

DEPRECATED. Get a specific PurchaseInvoice in UBL format with a Base64-encoded UBL string.

```APIDOC
## GET /purchase_invoices/{guid}/{packaging}/{package_version}

### Description
DEPRECATED. Get a specific PurchaseInvoice in UBL format.

### Method
GET

### Endpoint
/purchase_invoices/{guid}/{packaging}/{package_version}

### Parameters
#### Path Parameters
- **guid** (string) - Required - purchase invoice guid
- **packaging** (enum) - Required - How to package the purchase invoice. Options: ubl. Default: "ubl".
- **package_version** (enum) - Required - The version of the package. Options: si11, si12, si20, aunz, sg, jp, en16931, original. Default: "si11".

### Response
#### Success Response (200)
- **PurchaseInvoiceUbl** (object) - Success

#### Error Responses
- **401** - Unauthorized
- **403** - Forbidden
- **404** - Not Found
```

--------------------------------

### Execute API Request with cURL

Source: https://www.storecove.com/docs

Example of a POST request to the legal_entities endpoint using cURL.

```bash
curl \
-X POST "https://api.storecove.com/api/v2/legal_entities" \
-H "Accept: application/json" \
-H "Authorization: Bearer API_KEY_HERE" \
-H "Content-Type: application/json" \
-d "{ \"party_name\": \"Test Party\", \"line1\": \"Test Street\", \"city\": \"Test City\", \"zip\": \"Zippy\", \"country\": \"NL\", \"tenant_id\": \"my_id\"}"
```

--------------------------------

### Purchase Invoice JSON Object

Source: https://www.storecove.com/docs/with_deprecated

A complete example of a purchase invoice JSON object containing all available fields.

```json
{
  "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.",
  "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": "",
      "branche_code": "",
      "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": [
    {
      "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,
          "reason": "extra discount"
        }
      ],
      "price": {
        "amount": 10.25,
        "base_quantity": 1.0
      },
      "units": {
        "quantity": 1.0,
        "unit_code": "C62"
      },
      "amount_excluding_tax": 10.25,
      "tax": {
        "tax_amount": 0.00,
        "percentage": 0.00,
        "country": "US",
        "category": "standard",
        "type": "VAT"
      },
      "accounting": {
        "code": "code",
        "name": "code description",
        "list": "list of the code",
        "list_version": "list_version"
      },
      "note": "This is a note for this invoice line"
    }
  ],
  "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,
  },
  "accounting_currency_taxable_amount": 0.00,
  "accounting_currency_tax_amount": 0.00,
  "accounting_currency_exchange_rate": 1.00,
  "tax_subtotals": [
    {
      "amount_excluding_tax": 0.00,
      "tax": {
        "tax_amount": 0.00,
        "percentage": 0.00,
        "country": "US",
        "category": "standard",
        "type": "VAT"
      }
    }
  ]
}
```

--------------------------------

### GET /webhook_instances

Source: https://www.storecove.com/docs

Retrieves a new webhook instance from the pull mode queue.

```APIDOC
## GET /webhook_instances

### Description
Retrieves a new webhook off the queue in pull mode.

### Method
GET

### Endpoint
/webhook_instances

### Response
#### Success Response (200)
- **webhook** (object) - The webhook instance data

#### Success Response (204)
- No content - The queue is empty
```

--------------------------------

### GET /invoice_submissions/{guid}/evidence

Source: https://www.storecove.com/docs/with_deprecated

DEPRECATED. Get evidence for an InvoiceSubmission by GUID with corresponding status. Use the new /document_submissions/{guid}/evidence endpoint instead.

```APIDOC
## GET /invoice_submissions/{guid}/evidence

### Description
Deprecated. Use the new /document_submissions/{guid}/evidence endpoint. Get evidence for an InvoiceSubmission by GUID with corresponding status

### Method
GET

### Endpoint
/invoice_submissions/{guid}/evidence

### Parameters
#### Path Parameters
- **guid** (string) - Required - InvoiceSubmission GUID

### Response
#### Success Response (200)
- **evidence** (InvoiceSubmissionEvidence) - Success
```

--------------------------------

### GET /purchase_invoices/{guid}/{packaging}

Source: https://www.storecove.com/docs/with_deprecated

DEPRECATED. Get a specific PurchaseInvoice in a selectable format. Use the /api/v2/received_documents endpoint instead.

```APIDOC
## GET /purchase_invoices/{guid}/{packaging}

### Description
DEPRECATED. Use the /api/v2/received_documents endpoint. Get a specific PurchaseInvoice.

### Method
GET

### Endpoint
/purchase_invoices/{guid}/{packaging}

### Parameters
#### Path Parameters
- **guid** (string) - Required - purchase invoice guid
- **packaging** (enum) - Required - How to package the purchase invoice. Note that "ubl" is deprecated. Options: json, ubl, original. Default: "json".

#### Query Parameters
- **pmv** (string) - Optional - DEPRECATED. The PaymentMeans version. Default: "1.0".
- **version** (string) - Optional - The JSON content version date. Default: "1970-01-01".

### Response
#### Success Response (200)
- **PurchaseInvoiceUbl** (object) - Success

#### Error Responses
- **401** - Unauthorized
- **403** - Forbidden
- **404** - Not Found
```

--------------------------------

### Configure FACeB2B Routing

Source: https://www.storecove.com/docs

Partial JSON example for routing invoices through the Spanish FACeB2B network using ES:DIRE identifiers.

```json
  "routing": {
    "eIdentifiers":[
      {
        "scheme": "ES:DIRE",
        "id": "ESB705700150000"
      }
    ]
  },
  "document": {
    "documentType": "invoice",
    "invoice": {
      "accountingCustomerParty": {
        "publicIdentifiers": [
          {
            "scheme": "ES:VAT",
            "id": "ESB70570015"
          }
        ]
      }
    }
  }
```

--------------------------------

### Configure UAE Peppol Routing

Source: https://www.storecove.com/docs

Example of the routing object structure required for submitting PINT-AE invoices to a buyer in the UAE using their TIN.

```json
"routing": {
  "eIdentifiers": [
    {
      "scheme": "AE:TIN",
      "id": "1345678901"
    }
  ]
}
```

--------------------------------

### GET /purchase_invoices/{guid}

Source: https://www.storecove.com/docs/with_deprecated

DEPRECATED. Get a specific PurchaseInvoice in JSON format. Use the /api/v2/received_documents endpoint instead.

```APIDOC
## GET /purchase_invoices/{guid}

### Description
DEPRECATED. Use the /api/v2/received_documents endpoint. Get a specific PurchaseInvoice, in JSON format.

### Method
GET

### Endpoint
/purchase_invoices/{guid}

### Parameters
#### Path Parameters
- **guid** (string) - Required - The guid of the purchase invoice, from the webhook.

#### Query Parameters
- **pmv** (string) - Optional - DEPRECATED. The PaymentMeans version. Default: "1.0".
- **version** (string) - Optional - The JSON content version date. Default: "1970-01-01".

### Response
#### Success Response (200)
- **PurchaseInvoice** (object) - Success

#### Error Responses
- **401** - Unauthorized
- **403** - Forbidden
- **404** - Not Found
```

--------------------------------

### AEAT Verifactu Evidence Object

Source: https://www.storecove.com/docs

Example of the evidence object returned after processing, containing the tax_authority_deep_link.

```json
{
  "guid": "aaaaaaaa-aaaa-aaaa-aaaa-aaaaaaaaaaaaa",
  "sender": "9920:ESB99999999",
  "receiver": "AEAT",
  "documents": [
    {
      "mime_type": "application/pdf",
      "document": "https://xxxx",
      "expires_at": "2025-11-05 12:20:41+00:00"
    }
  ],
  "evidence": {
    "tax_authority_deep_link": "https://prewww2.aeat.es/wlpl/TIKE-CONT/ValidarQR?nif=B53625547&numserie=2025-10-28-ES-ES&fecha=28-10-2022&importe=1.21"
  },
  "network": "es-aeat-verifactu"
}
```

--------------------------------

### Retrieve Invoice Submission Evidence

Source: https://www.storecove.com/docs

Use this GET request to retrieve the digital signature or email delivery details for a submitted invoice. Replace the GUID in the URL with the specific invoice submission ID.

```bash
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"
```

--------------------------------

### GET /legal_entities/{legal_entity_id}/administrations/{id}

Source: https://www.storecove.com/docs/with_deprecated

DEPRECATED. Get an Administration.

```APIDOC
## GET /legal_entities/{legal_entity_id}/administrations/{id}

### Description
DEPRECATED. Get an Administration

### Method
GET

### Endpoint
/legal_entities/{legal_entity_id}/administrations/{id}

### Parameters
#### Path Parameters
- **id** (integer) - Required - The id of the Administration
- **legal_entity_id** (integer) - Required - The id of the LegalEntity the Administration belongs to

### Response
#### Success Response (200)
- **administration** (Administration) - Success
```

--------------------------------

### Configure AT:GOV Routing

Source: https://www.storecove.com/docs

Example JSON structure for routing invoices to the Austrian government, requiring specific public identifiers and purchase order references.

```json
{
  "routing":{
    "publicIdentifiers":[
      {
        "scheme":"AT:GOV",
        "id":"b"
      }
    ]
  },
  "document":{
    "documentType":"invoice",
    "invoice":{
      "x2y": "b2g",
      "references":[
        {
          "documentType":"purchase_order",
          "documentId":"XXX",
        }
      ],
      "accountingSupplierParty":{
        "party": {
          "customerAssignedAccountIdValue":"12345678"
        }
      }
    }
  }
}
```

--------------------------------

### IRAS Document Evidence JSON

Source: https://www.storecove.com/docs/with_deprecated

Example structure of the evidence object returned for documents sent to IRAS.

```json
{
   "guid": "11111111-1111-1111-1111-111111111111",
   "sender": "0195:SGUEN1111111111",
   "receiver": "8900:IRAS",
   "documents":[
      {
         "mime_type": "application/xml",
         "document": "https://deep.link",
         "expires_at": "2025-01-20 13:46:21+00:00"
      }
   ],
   "evidence":{
      "transmission_id": "33333333-3333-3333-3333-333333333333",
      "correlation_id": "44444444-4444-4444-4444-444444444444",
      "acknowledgement_id": "555555-55555555-5555-5555-555555555555-b001",
      "document_id": "22222222-2222-2222-2222-222222222222"
   },
   "network":"sg-iras"
}
```

--------------------------------

### SDI Error Response Structure

Source: https://www.storecove.com/docs

Example of the response_document content when an SDI (Italy) submission results in errors.

```json
{
  "errors": [
    {
      "code": "00306",
      "description": "1.4.1.2 <CodiceFiscale> non valido : AAAAAA00A00A000A"
    }
  ]
}
```

--------------------------------

### Get Purchase Invoice in Selectable Format

Source: https://www.storecove.com/docs/with_deprecated

Retrieves a purchase invoice in a specified format. Note that the 'ubl' packaging option is deprecated.

```http
GET /purchase_invoices/{guid}/{packaging}
```

--------------------------------

### Get Purchase Invoice with Base64 UBL

Source: https://www.storecove.com/docs/with_deprecated

Retrieves a specific purchase invoice in UBL format with a specified package version.

```http
GET /purchase_invoices/{guid}/{packaging}/{package_version}
```

--------------------------------

### IRAS Transmission Evidence JSON

Source: https://www.storecove.com/docs

Example structure of the evidence object returned for documents sent to IRAS.

```json
{
   "guid": "11111111-1111-1111-1111-111111111111",
   "sender": "0195:SGUEN1111111111",
   "receiver": "8900:IRAS",
   "documents":[
      {
         "mime_type": "application/xml",
         "document": "https://deep.link",
         "expires_at": "2025-01-20 13:46:21+00:00"
      }
   ],
   "evidence":{
      "transmission_id": "33333333-3333-3333-3333-333333333333",
      "correlation_id": "44444444-4444-4444-4444-444444444444",
      "acknowledgement_id": "555555-55555555-5555-5555-5555-555555555555-b001",
      "document_id": "22222222-2222-2222-2222-222222222222"
   },
   "network":"sg-iras"
}
```

--------------------------------

### GET /discovery/identifiers

Source: https://www.storecove.com/docs

Discover the identifiers used in each country for routing, legal identification, and tax purposes.

```APIDOC
## GET /discovery/identifiers

### Description
Discover the identifiers used in each country, for routing, for legal identification as well as for tax identification purposes. This is an experimental endpoint.

### Method
GET

### Endpoint
/discovery/identifiers

### Response
#### Success Response (200)
- **CountrySpecifications** (object) - Success

#### Error Responses
- **401** - Unauthorized
- **403** - Forbidden
```

--------------------------------

### Settlement (ROZ) and Advance (ZAL) Invoice Payloads

Source: https://www.storecove.com/docs

Examples for sending settlement invoices referencing prior advances and standard advance invoices.

```json
{
  "invoice": {
    "invoiceTypeCode": "380",
    "amountIncludingVat": 123.00,
    "prepaidAmount": 61.50,
    "references": [
      {
        "documentType": "advance_invoice",
        "documentId": "1111111111-20260716-123AB0000000-11"
      }
    ]
  }
}
```

```json
{
  "invoice": {
    "invoiceTypeCode": "386",
    "amountIncludingVat": 61.50
  }
}
```

--------------------------------

### Get Purchase Invoice JSON

Source: https://www.storecove.com/docs/with_deprecated

Retrieves a specific purchase invoice in JSON format. Use the /api/v2/received_documents endpoint instead.

```http
GET /purchase_invoices/{guid}
```

--------------------------------

### Received Document Webhook Event

Source: https://www.storecove.com/docs/with_deprecated

The webhook payload sent when a new document is received. It includes the document GUID and a parseable flag.

```APIDOC
## Received Document Webhook

### Description
This webhook is triggered when a new document is received for a tenant via an Exchange network.

### Payload
- **event_type** (string) - The type of event, always 'received_document'.
- **event_group** (string) - The group of the event, e.g., 'invoice'.
- **event** (string) - The status of the event, e.g., 'received' or 'failed'.
- **document_guid** (string) - The unique identifier for the document.
- **receive_guid** (string) - Optional. The unique identifier returned when POSTing a document to the ReceivedDocuments endpoint.
- **processing_notes** (array) - A list of notes regarding the processing status.
- **tenant_id** (string) - The ID of the tenant.
- **parseable** (boolean) - Indicates if the document was successfully parsed into JSON.

### Example Payload
{
  "event_type": "received_document",
  "event_group": "invoice",
  "event": "received",
  "document_guid": "f4624435-7fc4-4fc2-9379-dcb641d593dc",
  "processing_notes": [],
  "tenant_id": "YourTenantId",
  "parseable": true
}
```

--------------------------------

### Generate Client Library

Source: https://www.storecove.com/docs

Use the CLI to generate a client library from the OpenAPI specification.

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

--------------------------------

### Download Swagger Codegen CLI

Source: https://www.storecove.com/docs

Download the Swagger Codegen JAR file to begin generating client libraries.

```bash
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
```

--------------------------------

### GET /received_documents/{guid}/{format}

Source: https://www.storecove.com/docs

Retrieves a specific received document that was previously notified via webhook.

```APIDOC
## GET /received_documents/{guid}/{format}

### Description
Get a new ReceivedDocument that you have been notified for via received_document webhook.

### Method
GET

### Endpoint
/received_documents/{guid}/{format}

### Parameters
#### Path Parameters
- **guid** (string) - Required - The guid of the document that was received.
- **format** (enum) - Optional - The format in which to receive the received document (json, original).

#### Query Parameters
- **version** (string) - Optional - The JSON content version date.
```

--------------------------------

### Enable AEAT Verifactu Application

Source: https://www.storecove.com/docs

Configuration snippet to enable the es-aeat-verifactu application within the routing object.

```json
  "routing": {
    "networks": [
      {
        "application": "es-aeat-verifactu",
        "settings": {
          "enabled": true
        }
      }
    ]
  }
```

--------------------------------

### Get Document Submission Evidence

Source: https://www.storecove.com/docs

Retrieves evidence for a specific document submission using its GUID and the desired evidence type.

```http
GET /document_submissions/{guid}/evidence/{evidence_type}
```

--------------------------------

### GET /api/v2/document_submissions/{guid}/evidence

Source: https://www.storecove.com/docs

Retrieves the evidence for a successfully sent invoice, including digital signatures or email delivery details.

```APIDOC
## GET /api/v2/document_submissions/{guid}/evidence

### Description
Retrieves the evidence for a successfully sent invoice. This includes the exact invoice sent, digital signatures from the receiving access point or tax authority, or email delivery details if sent via email.

### Method
GET

### Endpoint
https://api.storecove.com/api/v2/document_submissions/{guid}/evidence

### Parameters
#### Path Parameters
- **guid** (string) - Required - The unique identifier received when the invoice was submitted.

### Request Example
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"
```

--------------------------------

### GET /legal_entities/{id}

Source: https://www.storecove.com/docs

Get a specific LegalEntity.

```APIDOC
## GET /legal_entities/{id}

### Description
Get a specific LegalEntity.

### Method
GET

### Endpoint
/legal_entities/{id}

### Parameters
#### Path Parameters
- **id** (integer) - Required - legal_entity id

### Response
#### Success Response (200)
- **LegalEntity** (object) - Success

#### Error Responses
- **401** - Unauthorized
- **403** - Forbidden
- **404** - Not Found
```

--------------------------------

### POST /discovery/receives

Source: https://www.storecove.com/docs

Discover a network participant and their capabilities.

```APIDOC
## POST /discovery/receives

### Description
Discover a network participant and their capabilities.

### Method
POST

### Endpoint
/discovery/receives

### Parameters
#### Request Body
- **discoverable_participant** (DiscoverableParticipant) - Required - The participant to check

### Response
#### Success Response (200)
- **DiscoveredParticipant** (object) - Success

#### Error Responses
- **401** - Unauthorized
- **403** - Forbidden
- **422** - Unprocessable Entity (ErrorModel array)
```

--------------------------------

### List Supported Languages

Source: https://www.storecove.com/docs

Display all languages supported by the Swagger Codegen tool.

```bash
java -jar swagger-codegen-cli.jar langs
```

--------------------------------

### Combine AEAT Verifactu with Peppol

Source: https://www.storecove.com/docs

Routing configuration to report to AEAT Verifactu while routing the invoice via the Peppol network.

```json
  "routing": {
    "eIdentifiers":[
      {
        "scheme": "ES:VAT",
        "id": "ESB53625999"
      }
    ],
    "networks": [
      {
        "application": "es-aeat-verifactu",
        "settings": {
          "enabled": true
        }
      }
    ]
  }
```

--------------------------------

### Get LegalEntity

Source: https://www.storecove.com/docs

Retrieves a specific LegalEntity by its unique identifier.

```http
GET /legal_entities/{id}
```

--------------------------------

### Configure optional import/export fields

Source: https://www.storecove.com/docs

Additional fields for item classification, trade agreements, and shipment origin details.

```json
{
  "document": {
    "invoice": {
      "invoiceLines": [
        {
          "references": [
            {
              "documentType": "item_classification_code",
              "documentIdListId": "PTC",
              "documentId": "123456"
            }
          ]
        }
      ],
      "references": [
        {
          "documentType": "my_customs_form_2",
          "documentId": "Reference Number of Customs Form No.2"
        },
        {
          "documentType": "free_trade_agreement",
          "documentId": "Free Trade Agreement"
        }
      ],
      "delivery": {
        "shipment": {
          "originAddress": {
            "country": "SG"
          },
          "allowanceCharges": [
            {
              "amountExcludingTax": 1234,
              "reason": "why?",
              "taxesDutiesFees": [
                {
                  "category": "exempt",
                  "country": "MY",
                  "percentage": 0.0
                }
              ]
            }
          ]
        }
      }
    }
  }
}
```

--------------------------------

### Get AdditionalTaxIdentifier

Source: https://www.storecove.com/docs

Retrieves details of a specific AdditionalTaxIdentifier by its ID.

```http
GET /legal_entities/{legal_entity_id}/additional_tax_identifiers/{id}
```

--------------------------------

### POST /legal_entities

Source: https://www.storecove.com/docs

Create a new LegalEntity.

```APIDOC
## POST /legal_entities

### Description
Create a new LegalEntity.

### Method
POST

### Endpoint
/legal_entities

### Parameters
#### Request Body
- **legal_entity** (LegalEntityCreate) - Required - LegalEntity to create

### Response
#### Success Response (200)
- **LegalEntity** (object) - Success

#### Error Responses
- **401** - Unauthorized
- **403** - Forbidden
- **422** - Unprocessable Entity (ErrorModel array)
```

--------------------------------

### DELETE /webhook_instances/{guid}

Source: https://www.storecove.com/docs

Deletes a specific WebhookInstance from the queue.

```APIDOC
## DELETE /webhook_instances/{guid}

### Description
DELETE a specific WebhookInstance

### Method
DELETE

### Endpoint
/webhook_instances/{guid}

### Parameters
#### Path Parameters
- **guid** (string) - Required - WebhookInstance guid
```

--------------------------------

### GET /legal_entities/{legal_entity_id}/additional_tax_identifiers/{id}

Source: https://www.storecove.com/docs

Retrieve details of a specific AdditionalTaxIdentifier.

```APIDOC
## GET /legal_entities/{legal_entity_id}/additional_tax_identifiers/{id}

### Description
Get an AdditionalTaxIdentifier

### Method
GET

### Endpoint
/legal_entities/{legal_entity_id}/additional_tax_identifiers/{id}

### Parameters
#### Path Parameters
- **id** (integer) - Required - The id of the AdditionalTaxIdentifier
- **legal_entity_id** (integer) - Required - The id of the LegalEntity the AdditionalTaxIdentifier belongs to

### Response
#### Success Response (200)
- **AdditionalTaxIdentifier** (object) - Success
```

--------------------------------

### Combine AEAT Verifactu with FACeB2B

Source: https://www.storecove.com/docs

Routing configuration to report to AEAT Verifactu while routing the invoice via the FACeB2B network.

```json
  "routing": {
    "eIdentifiers":[
      {
        "scheme": "ES:DIRE",
        "id": "ESB705700150000"
      }
    ],
    "networks": [
      {
        "application": "es-aeat-verifactu",
        "settings": {
          "enabled": true
        }
      }
    ]
  }
```

--------------------------------

### Create a new LegalEntity

Source: https://www.storecove.com/docs

Sends a POST request to create a new LegalEntity resource.

```http
POST /legal_entities
```

--------------------------------

### LegalEntityCreate

Source: https://www.storecove.com/docs

Defines the schema and parameters for creating a new LegalEntity.

```APIDOC
## LegalEntityCreate

### Description
Creates a new LegalEntity. This entity can be configured to act as a sender or receiver of documents and supports various document types for advertisement.

### Parameters
#### Request Body
- **acts_as_receiver** (boolean) - Optional - Whether or not this LegalEntity can act as a receiver of documents. Default: true.
- **acts_as_sender** (boolean) - Optional - Whether or not this LegalEntity can act as a sender of documents. Default: true.
- **advertisements** (array) - Optional - A list of document groups to advertise (invoice, invoice_response, selfbilling, order, ordering, advanced_ordering, advanced_ordering_sg_order_balance, remittance_advice, pidx_invoicing_ordering).
- **city** (string) - Required - The city. Length: 2 - 64.
- **country** (Country) - Required - The country.
- **county** (string) - Optional - County, if applicable. Max length: 64.
- **line1** (string) - Required - The first address line. Length: 2 - 192.
- **line2** (string) - Optional - The second address line, if applicable. Max length: 192.
- **override_own_credentials** (boolean) - Optional - If true, Storecove will use default credentials/signing artifacts. Default: false.
- **party_name** (string) - Required - The name of the company. Length: 2 - 64.
- **passport_issuing_country** (string) - Optional - ISO 3166-1 alpha-2 country code or Peppol extension 1A. Pattern: ^(?:[A-Z]{2}|1A)$.
- **public** (boolean) - Optional - Whether or not this LegalEntity is public. Default: true.
- **rea** (Rea) - Optional - The REA details for the LegalEntity (IT only).
- **registration_authority_name** (string) - Optional - Name of the authority that issued the legal registration identifier. Length: 1 - 255.
- **tax_registered** (boolean) - Optional - Whether or not this LegalEntity is tax registered. Default: true.
- **tenant_id** (string) - Optional - The id of the tenant. Max length: 64.
- **third_party_password** (string) - Optional - Password for third-party system authentication (India only). Length: 2 - 64.
- **third_party_username** (string) - Optional - Username for third-party system authentication (India only). Length: 2 - 64.
- **zip** (string) - Required - The zipcode. Length: 2 - 32.
```

--------------------------------

### POST /api/v2/legal_entities/{legal_entity_id}/c5/iras/redirect/activate

Source: https://www.storecove.com/docs

Request a new C5 Redirect Activation.

```APIDOC
## POST /api/v2/legal_entities/{legal_entity_id}/c5/iras/redirect/activate

### Description
Request a new C5 Redirect Activation. Currently only used for SG:UEN identifiers towards SG IRAS.

### Method
POST

### Endpoint
/api/v2/legal_entities/{legal_entity_id}/c5/iras/redirect/activate

### Parameters
#### Path Parameters
- **legal_entity_id** (integer) - Required - The id of the LegalEntity for which to create the C5RedirectRequest

#### Request Body
- **c5_redirect_request** (C5RedirectRequest) - Required - The C5RedirectRequest to initiate

### Response
#### Success Response (200)
- **C5RedirectResponse** (object) - Success response

#### Error Response (401, 403, 404, 422)
- 401: Unauthorized
- 403: Forbidden
- 404: Not Found
- 422: Unprocessable Entity (C5RedirectResponse)
```

--------------------------------

### Invoice Submission Response

Source: https://www.storecove.com/docs

The response returned after a successful invoice submission, containing the unique document GUID.

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

--------------------------------

### Submit Credit Note with Reason Code and Billing Reference

Source: https://www.storecove.com/docs

The creditNoteReasonCode field is mandatory. A billing reference must be included unless the reason code is 'VD' for volume discount.

```json
{
  "legalEntityId": 123456789,
  "routing": {
    "eIdentifiers": [
      { "scheme": "AE:TIN", "id": "1345678901" }
    ]
  },
  "document": {
    "documentType": "invoice",
    "invoice": {
      "taxSystem": "tax_line_percentages",
      "invoiceNumber": "AE-2026-0003",
      "issueDate": "2026-07-02",
      "issueTime": "10:00:00",
      "timeZone": "+0400",
      "documentCurrencyCode": "AED",
      "documentUuid": "7d4e5f6a-1b2c-4d3e-9f8a-7b6c5d4e3f2a",
      "buyerReference": "BUYER-REF-3",
      "creditNoteReasonCode": "DL8.61.1.C",
      "references": [
        {
          "documentType": "billing",
          "documentId": "AE-2026-0001",
          "issueDate": "2026-07-01"
        }
      ],
      "accountingCustomerParty": {
        "party": {
          "companyName": "Buyer Trade Name",
          "registrationAuthorityName": "Department of Economy and Tourism",
          "address": {
            "street1": "Buyer Street 1",
            "zip": "00000",
            "city": "Dubai",
            "county": "DU",
            "country": "AE"
          }
        },
        "publicIdentifiers": [
          { "scheme": "AE:TIN", "id": "1345678901" },
          { "scheme": "AE:TRN", "id": "134567890123403" },
          { "scheme": "AE:TL", "id": "CN-1234567" }
        ]
      },
      "invoiceLines": [
        {
          "name": "Returned consulting goods",
          "amountExcludingVat": -100.0,
          "quantity": -1.0,
          "quantityUnitCode": "C62",
          "itemPrice": 100.0,
          "itemType": "G",
          "references": [
            {
              "documentType": "item_classification_code",
              "documentIdListId": "HS",
              "documentId": "88098432"
            }
          ],
          "tax": {
            "percentage": 5.0,
            "category": "standard",
            "country": "AE"
          }
        }
      ],
      "taxSubtotals": [
        {
          "taxableAmount": -100.0,
          "taxAmount": -5.0,
          "percentage": 5.0,
          "category": "standard",
          "country": "AE"
        }
      ],
      "amountIncludingVat": -105.0
    }
  }
}
```
Tokens:
Raw