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
    • Renew token
  • 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 an invoice with seller information
        POST
      • Submit a batch of sales invoices
        POST
      • List batch uploads and export lines
        GET
      • 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
    • SalesInvoiceBatchResponse
    • OnlineInvoiceBatchProcedureOutcomeDto
    • OnlineInvoiceBatchListResponse
    • OnlineInvoiceBatchListItemDto
    • OnlineInvoiceBatchExportLineDto
    • BatchInvoices
    • SalesInvoice
    • 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
    • SalesInvoiceBatchResponse
    • SalesInvoicePayment
    • SalesInvoiceResponse
    • SalesInvoiceRow
    • SalesInvoiceUpdate
    • SalesInvoiceUpdateResponse
    • SalesInvoiceWithSellerInfoDTO
    • SalesItemResponse
    • SalesItems
    • SellerInfoDTO
    • Settlement
    • SettlementList
    • SettlementRows
    • SmsData
    • SmsDeliveryReport
    • SmsResponse
    • ValidationResponse
    • ViewOnlineInvoiceDeliveryStats
  1. Invoice Service

Submit a batch of sales invoices

POST
https://api.cash-in.com/v2/batchsalesinvoices
Submit large number of sales invoices

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
Batch accepted for processing.
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": 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,
                    "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 Response Example
202 - Example 1
{
    "StatusDescription": "string",
    "QtyOfInvoices": 0,
    "BatchId": 0,
    "BatchUrl": "string"
}
Previous
Create an invoice with seller information
Next
List batch uploads and export lines
Built with