Create an invoice with seller information

POST

https://api.cash-in.com/v2/gen-invoice-with-seller-info

This API endpoint is for the authenticated Intermediation Seller to generate new sales invoice with seller information attached per invoice.
Supports single invoice in one JSON payload.

Request

Authorization

API Key

Add parameter in header

X-Api-Key

Example:

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

Body Params application/json

Examples

Responses

🟢202

application/json

Accepted

Body

🟠400

🟠401

Request Example

Shell

JavaScript

Java

Swift

curl --location --request POST 'https://api.cash-in.com/v2/gen-invoice-with-seller-info' \
--header 'X-Api-Key: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '[
    {
        "SellerInfo": {
            "BusinessCode": "string",
            "BusinessName": "string",
            "VatCode": "string",
            "StreetAddress": "string",
            "PostalCode": "string",
            "PostalDistrict": "string",
            "CountryCode": "string",
            "CountryName": "string",
            "SiteCode": "string",
            "ContactPerson": "string",
            "ContactPersonEmail": "user@example.com",
            "CommonEmail": "user@example.com",
            "CommonPhone": "string",
            "IBAN_1": "string",
            "IBAN_2": "string",
            "IBAN_3": "string",
            "BIC_1": "string",
            "BIC_2": "string",
            "BIC_3": "string",
            "HomeTown": "string",
            "Website": "http://example.com"
        },
        "SalesInvoice": {
            "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 - Example 1

{
    "StatusDescription": "string",
    "UploadedInvoicesCount": 0,
    "FailedInvoicesCount": 0,
    "FailedInvoices": "string"
}

Create batch of invoices

List all sales invoices