1. Invoice Service
Cash-In API
  • Introduction
  • Access tokens
  • Environments
  • Errors
  • Contact us
  • Resources
    • Services
    • Invoice Intermediation service
    • Invoice Lifecycle service
    • Debt Collection service
    • Debt Collection process
    • Confirma Software Partner services
  • Authorization
    • Authentication and authorization of the user
    • Validate token
      GET
    • Renew token
      GET
  • Collection & Payment Control
    • Create Collection Cases
    • Update Collection Receivables
    • Retrieve Collection Receivables Status
    • Retrieve Case Batch Status
    • Retrieve collection case
    • Retrieve debtor summary
    • Retrieve list of settlements
    • Retrieve settlement data
    • Retrieve list of direct settlements
    • Retrieve direct settlement data
    • Retrieve Credit Loss Receivables
  • Invoice Intermediation
    • Invoice Service
      • Create an invoice
        POST
      • Create batch of invoices
        POST
      • Create an invoice with seller information
        POST
      • List all sales invoices
        GET
      • Retrieve invoice delivery information
        GET
      • Retrieve invoice status
        GET
      • Update an invoice
        PUT
      • Submit payment for an invoice
        POST
      • Retrieve delivery statistics
        GET
      • Retrieve received payments
        GET
      • Submit update to Finvoice Account
        PUT
      • Retrieve electronic invoicing contracts
        GET
    • Product Management
      • List all products
      • Submit new products
      • Delete an product
    • Customer Management
      • List all customers
      • Submit new customers
      • Update an customer
      • Delete an customer
    • External invoices
      • Retrieve delivery information
      • Retrieve payment information
      • Create an direct payment
      • Submit an invoice action
      • Retrieve status of the agreement
  • Confirma Software Partners
    • Submit new creditor
    • Update creditor
    • Retrieve creditor credentials
    • Retrieve External Agreement Identifiers
    • Retrieve invoice delivery information by seller
    • Send SMS message
  • Document Print Service
    • Create meter reading documents
  • Schemas
    • BatchDataResponse
    • BatchInvoices
    • BatchInvoicesList
    • BatchStatus
    • Case
    • CaseInvoiceExtended
    • CaseList
    • CaseSummary
    • CollectionResponse
    • ContactPerson
    • CreditLossReceivable
    • Creditor
    • CreditorData
    • CreditorDetails
    • CreditorIdentifiers
    • CreditorResponse
    • CreditorUpdateData
    • CreditorUpdateDetails
    • CreditorUpdateResponse
    • CustomParameters
    • Debtor
    • DirectSettlementList
    • DirectSettlementRows
    • DirectSettlements
    • DocumentCustomer
    • DocumentResponse
    • ElectronicInvoicingContracts
    • ErrorMessage
    • ExternalAgreementIdentifiers
    • ExternalAgreementStatusResponse
    • ExternalInvoice
    • ExternalInvoiceActions
    • ExternalInvoiceRows
    • FinvoiceAccountUpdate
    • FinvoiceAccountUpdateResponse
    • IntegrationsAccountingLedgerData
    • IntermediationInvoiceDirectPaymentResponse
    • IntermediationInvoiceDirectPayments
    • IntermediatorInvoice
    • Invoice
    • InvoiceActionResponse
    • InvoicePaymentsResponse
    • InvoicesDeliveryInformation
    • LedgerRowDimensions
    • LedgerRows
    • Ledgers
    • Messages
    • MeterCompany
    • MeterDocument
    • MeterDocumentList
    • MeterReading
    • MeterUsageLocation
    • NxsReceivedPayments
    • OnlineCustomer
    • OnlineCustomerResponse
    • OnlineCustomerUpdateResponse
    • OnlineInvoicePaymentControl
    • OnlineProduct
    • OnlineSalesInvoices
    • PagedSalesInvoicesResponse
    • Payment
    • Receivable
    • ReceivablesList
    • ReceivedPaymentRows
    • ReceivedPayments
    • ReceivedPaymentsResponse
    • RenewResponse
    • SalesAddressDTO
    • SalesInvoice
    • SalesInvoiceBatchResponse
    • SalesInvoicePayment
    • SalesInvoiceResponse
    • SalesInvoiceRow
    • SalesInvoiceUpdate
    • SalesInvoiceUpdateResponse
    • SalesInvoiceWithSellerInfoDTO
    • SalesItemResponse
    • SalesItems
    • SellerInfoDTO
    • Settlement
    • SettlementList
    • SettlementRows
    • SmsData
    • SmsDeliveryReport
    • SmsResponse
    • ValidationResponse
    • ViewOnlineInvoiceDeliveryStats
  1. Invoice Service

Create batch of invoices

POST
https://api.cash-in.com/v2/batchsalesinvoices
Post of an batch of sales invoices.
When the number of invoices is large, it is recommended to use this endpoint instead of the single invoice endpoint.

Request

Authorization
API Key
Add parameter in header
X-Api-Key
Example:
X-Api-Key: ********************
or
Body Params application/jsonRequired

Examples

Responses

🟢202
application/json
Accepted
Body

🟠400
🟠401
Request Request Example
Shell
JavaScript
Java
Swift
curl --location --request POST 'https://api.cash-in.com/v2/batchsalesinvoices' \
--header 'X-Api-Key: <api-key>' \
--header 'Content-Type: application/json' \
--data-raw '{
    "SalesInvoices": [
        {
            "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 Response Example
202 - Example 1
{
    "StatusDescription": "string",
    "QtyOfInvoices": 0,
    "BatchId": 0,
    "BatchUrl": "string"
}
Previous
Create an invoice
Next
Create an invoice with seller information
Built with