Create an invoice

POST

https://api.cash-in.com/v2/gensalesinvoices

Post an payload containing one or many sales invoices to create them in Cash-In Invoice Service.

Request

Authorization

API Key

Add parameter in header

X-Api-Key

Example:

X-Api-Key: ********************

Body Params application/json

Examples

Responses

🟢202

application/json

Invoice(s) created

Bodyapplication/json

🟠400

🟠401

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://api.cash-in.com/v2/gensalesinvoices' \
--header 'X-Api-Key: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '[
    {
        "InvoiceNumber": 0,
        "Status": "O",
        "InvoiceDate": "2019-08-24T14:15:22.123Z",
        "DueDate": "2019-08-24T14:15:22.123Z",
        "SalesReference": "string",
        "BuyersReference": "string",
        "OrderIdentifier": "string",
        "OrderDate": "2019-08-24T14:15:22.123Z",
        "AgreementIdentifier": "string",
        "PaymentTermsCode": 0,
        "PaymentTermsDescription": "string",
        "PaymentTermsInterestRate": "string",
        "InvoiceLanguage": "FI",
        "Currency": "EUR",
        "NetAmount": 0,
        "DiscAmount": 0,
        "RoundAmount": 0,
        "TaxAmount": 0,
        "TotalAmount": 0,
        "Reference": "string",
        "Description": "string",
        "SalesName": "string",
        "SalesName2": "string",
        "SalesStreetAddress": "string",
        "SalesStreetAddress2": "string",
        "SalesPostalCode": "string",
        "SalesCity": "string",
        "SalesCountry": "FI",
        "SalesType": "H",
        "SalesCustomerCode": "string",
        "SalesIdentifier": "string",
        "SalesEmail": "user@example.com",
        "SalesPhone": "string",
        "InvoiceType": "I",
        "InterestType": "V",
        "InterestNumber": 0,
        "VirtualBankBarcode": "string",
        "DeliveryType": "E",
        "PaymentType": "FL",
        "IssueDate": "2019-08-24T14:15:22.123Z",
        "FinvoiceVersion": "string",
        "FinvoiceSpecification": "string",
        "FinvoiceAccount": "string",
        "FinvoiceOVT": "string",
        "AutoAdvancement": 0,
        "InvoiceCopyUrl": "string",
        "BillingName1": "string",
        "BillingName2": "string",
        "BillingStreetAddr1": "string",
        "BillingStreetAddr2": "string",
        "BillingStreetAddr3": "string",
        "BillingPostalCode": "string",
        "BillingCity": "string",
        "BillingCountry": "string",
        "BillingEmailAddress": "user@example.com",
        "DeliveryName": "string",
        "DeliveryName2": "string",
        "DeliveryStreetAddr1": "string",
        "DeliveryStreetAddr2": "string",
        "DeliveryStreetAddr3": "string",
        "DeliveryPostalCode": "string",
        "DeliveryCity": "string",
        "DeliveryCountry": "str",
        "ExtendedField1": "string",
        "ExtendedField2": "string",
        "ExtendedField3": "string",
        "ExtendedField4": "string",
        "ExtendedField5": "string",
        "ExtendedField6": "string",
        "ExtendedField7": "string",
        "ExtendedField8": "string",
        "ExtendedField9": "string",
        "ExtendedField10": "string",
        "CreditedInvoiceInformation": "string",
        "InvoiceRows": [
            {
                "ProdCode": null,
                "Description": "Myyntituotteen nimi",
                "VatPercent": 24,
                "ShipDate": null,
                "Qty": 1,
                "Price": 100,
                "Discount": 0,
                "Nto": 100,
                "Tax": 24,
                "Round": 0,
                "Total": 100,
                "Text": null,
                "Type": "I",
                "DiscountPercent": 0,
                "Unit": "kpl",
                "VatType": "N",
                "Currency": "EUR",
                "StartDate": "2022-01-20",
                "EndDate": "2022-01-20",
                "BuyerArticleId": "string",
                "EanCode": "string",
                "SerialNumber": "string",
                "DeliveryIdentifier": "string",
                "DeliveryDate": "2022-01-20",
                "ManufacturerOrderId": "string",
                "MeterNbr": "string",
                "MeterStartValue": "string",
                "MeterEndValue": "string",
                "MeterTimePeriod": "string"
            }
        ]
    }
]'

Response Example

202 - Successful upload of invoice(s)

{
    "StatusDescription": "Successfull upload of sales invoices (1).",
    "UploadedInvoicesCount": 1,
    "FailedInvoicesCount": 0,
    "FailedInvoices": null
}

Retrieve allocated payment transactions

Create an invoice with seller information