---
title: "DEPRECATED. Submit a new invoice"
method: POST
path: "/invoice_submissions"
tags: ["InvoiceSubmissions"]
---

# DEPRECATED. Submit a new invoice

`POST /invoice_submissions`

DEPRECATED. Use the new /document_submissions endpoint. Submit an invoice for delivery.

## Request body

- InvoiceSubmission — DEPRECATED. The invoice you want Storecove to process, with some meta-data.
  - `createPrimaryImage` boolean — DEPRECATED. In the future we will no longer support creating PDF invoices. Whether or not to create a primary image (PDF) if one is not provided. For customers who started from December 1st 2022, the default is false. For customers who started before that, the default is true.
  - `mode` 'direct' — DEPRECATED.
  - `supplierId` integer — DEPRECATED.
  - `legalSupplierId` integer — DEPRECATED. Use legalEntityId
  - `legalEntityId` integer — The id of the LegalEntity this invoice should be sent for.
  - `idempotencyGuid` string — A guid that you generated for this InvoiceSubmission to achieve idempotency. If you submit multiple documents with the same idempotencyGuid, only the first one will be processed.
  - `invoiceRecipient` InvoiceRecipient — DEPRECATED. Use the Routing object. The different ways to send the invoice to the recipient. The publicIdentifiers are used to send via the Peppol network, if the recipient is not registered on the Peppol network, the invoice will be sent to the email addresses in the emails property. This property is only mandatory when sending the invoice data using the <<_openapi_invoice>> property, not when sending using the <<_openapi_invoicedata>> property, in which case this information will be extracted from the <<_openapi_invoicedata>> object. If you do specify an <<_openapi_invoicerecipient>> object and an <<_openapi_invoicedata>> object, the data from the two will be merged.
    - `publicIdentifiers` PublicIdentifier[] — A list of public identifiers that uniquely identify this customer.
      - `scheme` string, required — The scheme of the identifier. See <<_receiver_identifiers_list>> for a list.
      - `id` string, required — The actual identifier.
    - `emails` string[] — The email addresses the invoice should be sent to if none of the other identifiers can be used
  - `routing` Routing — The different ways to send the invoice to the recipient. The publicIdentifiers are used to send via the Peppol network, if the recipient is not registered on the Peppol network, the invoice will be sent to the email addresses in the emails property. This property is only mandatory when sending the invoice data using the <<_openapi_invoice>> property, not when sending using the <<_openapi_invoicedata>> property, in which case this information will be extracted from the <<_openapi_invoicedata>> object. If you do specify an <<_openapi_invoicerecipient>> object and an <<_openapi_invoicedata>> object, the data from the two will be merged.
    - `eIdentifiers` RoutingIdentifier[] — A list of electronic routing identifiers. These are the identifiers used on the Peppol network or for other destinations.
      - `scheme` string, required — The scheme of the identifier. See <<_receiver_identifiers_list>> for a list.
      - `id` string, required — The actual identifier.
      - `role` 'es_01_fiscal' | 'es_02_receptor' | 'es_03_pagador' — The role of the identifier. Only used for B2G sending to ES.
    - `networks` RoutingNetwork[] — Any additional networks to consider for routing
      - `scheme` string — The name of the network
      - `settings` NetworkSettings, required — Settings for an additional routing network.
        - `scheme` boolean — Whether or not the network is enabled
        - `mock` boolean — Whether or not to mock the network, if possible.
    - `emails` string[] — The email addresses the invoice should be sent to if none of the other identifiers can be used
    - `clearWithoutSending` boolean — If you wish to send the document yourself in a Y-flow, use this flag. Wait for the 'cleared' webhook and use the <<_openapi_show_document_submission_evidence>> endpoint to retrieve the clearing evidence. This will include a sendable document.
  - `attachments` Attachment[] — An array of attachments. You may provide up to 10 attchments, but the total size must not exceed 100MB after Base64 encoding.
    - `document` string, required — The base64 encoded version of the document attachment.
    - `mimeType` 'text/csv' | 'application/pdf' | 'image/png' | 'image/jpeg' | 'application/vnd.openxmlformats-officedocument.spreadsheetml.sheet' | 'application/vnd.oasis.opendocument.spreadsheet', required — The document attachment mime type.
    - `filename` string — The name of the file attachment.
    - `description` string — A description for the file attachment.
    - `documentId` string — An id for the file attachment.
    - `primaryImage` boolean — DEPRECATED. Whether or not this document is a visual representation of the invoice data. Note that using value 'true' is discouraged, since the invoice data itself is leading, not the image, and including an image may lead to confusion. Peppol no longer allows including primary images.
  - `document` string — DEPRECATED. Use attachments.
  - `documentUrl` string, uri — DEPRECATED. Use attachments.
  - `invoice` Invoice — unresolved $ref
  - `invoiceData` InvoiceData — DEPRECATED. Use RawDocumentData. The invoice to send, in base64 encoded format. Provide either invoice, or invoiceData, but not both.
    - `conversionStrategy` 'ubl' | 'cii' | 'idoc' | 'setu14' — How to interpret the document.
    - `document` string — The base64 encoded version of the document.

## Response `200`

Success

- InvoiceSubmissionResult — The result of an invoice submission
  - `guid` string — A (V4) GUID for the invoice submission

## Other responses

- `401` — Unauthorized
- `403` — Forbidden
- `422` — Unprocessable Entity

---

[API](https://skmtc.net/storecove/apis/storecove-api.md) · [All operations](https://skmtc.net/storecove/apis/storecove-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/storecove/storecove-api/revisions/7f72642d80e6/schema)