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

Body

🟠400

🟠401

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.cash-in.com/v2/gensalesinvoices' \
--header 'X-Api-Key: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '[
    {
        "InvoiceNumber": 251600002,
        "Status": "H",
        "InvoiceDate": "2022-01-20",
        "DueDate": "2022-02-04",
        "SalesReference": null,
        "BuyersReference": null,
        "OrderIdentifier": "string",
        "OrderDate": "2019-08-24T14:15:22.123Z",
        "AgreementIdentifier": "string",
        "PaymentTermsCode": 14,
        "InvoiceLanguage": "FI",
        "Currency": "EUR",
        "NetAmount": 76,
        "DiscAmount": 0,
        "RoundAmount": 0,
        "TaxAmount": 24,
        "TotalAmount": 100,
        "Reference": "2516000017",
        "Description": null,
        "SalesName": "Sami Santikko",
        "SalesName2": null,
        "SalesStreetAddress": "Kauppapuistikko 17 A 23",
        "SalesStreetAddress2": null,
        "SalesPostalCode": "65100",
        "SalesCity": "VAASA",
        "SalesCountry": "FI",
        "SalesType": "H",
        "SalesCustomerCode": "6654",
        "SalesIdentifier": null,
        "SalesEmail": "sami.santikko@gmail.com",
        "SalesPhone": "0400-989801",
        "InvoiceType": "I",
        "InterestType": "V",
        "InterestNumber": 8,
        "VirtualBankBarcode": null,
        "DeliveryType": "E",
        "PaymentType": "string",
        "IssueDate": "2019-08-24T14:15:22.123Z",
        "FinvoiceVersion": "2.01",
        "FinvoiceSpecification": "B2C",
        "FinvoiceAccount": null,
        "FinvoiceOVT": null,
        "AutoAdvancement": 1,
        "InvoiceCopyUrl": "https://my.company.com/download?invoice=123456",
        "BillingName1": "Laskutuksen nimikenttä 1",
        "BillingName2": "Laskutuksen nimikenttä 2",
        "BillingStreetAddr1": "Laskutuksen osoitekenttä",
        "BillingStreetAddr2": "Laskutuksen toinen osoitekenttä",
        "BillingStreetAddr3": "Laskutuksen kolmas osoitekenttä",
        "BillingPostalCode": "00100",
        "BillingCity": "HELSINKI",
        "BillingCountry": "FI",
        "BillingEmailAddress": "laskutus@laskutus.fi",
        "DeliveryName": "Toimitusosoitteen nimikenttä",
        "DeliveryName2": "Toimitusosoitteen toinen nimikenttä",
        "DeliveryStreetAddr1": "Toimitusosoitteen osoitekenttä",
        "DeliveryStreetAddr2": "Toimitusosoitteen toinen osoitekenttä",
        "DeliveryStreetAddr3": null,
        "DeliveryPostalCode": "00100",
        "DeliveryCity": "HELSINKI",
        "DeliveryCountry": "FI",
        "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 Credit Loss Receivables

Create batch of invoices