1. Invoice Service
Cash-In API
  • Introduction
  • Authentication & security
  • Environments
  • Errors
  • Contact us
  • Resources
    • Services
    • Invoice Intermediation service
    • Invoice Lifecycle service
    • Debt Collection service
    • Debt Collection process
    • Cash-In Client Portal
    • Print & Distribution service
    • Confirma Software Partner services
    • Go-Live & Deployment Guide
    • General data types
    • Invoice Service Data types
    • Release Notes
  • Token endpoints
    • Validate token
    • Renew token
  • Collection endpoints
    • 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
    • Retrieve allocated payment transactions
  • Invoice endpoints
    • 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
  • Partner endpoints
    • Submit new creditor
    • Update creditor
    • Retrieve Creditor Credentials
    • Retrieve Finvoice Credentials
    • Retrieve External Agreement Identifiers
    • Retrieve invoice delivery information by seller
    • Send SMS message
  • Document endpoints
    • Create meter reading documents
  • Operations endpoints
    • Service Status
  • Schemas
    • BatchDataResponse
    • SalesInvoiceBatchResponse
    • OnlineInvoiceBatchProcedureOutcomeDto
    • OnlineInvoiceBatchListResponse
    • OnlineInvoiceBatchListItemDto
    • OnlineInvoiceBatchExportLineDto
    • AllocatedPaymentTransactionsResponse
    • Finvoice Registry Credentials Record
    • BatchInvoices
    • AllocatedPaymentTransactionItem
    • SalesInvoice
    • BatchInvoicesList
    • PaymentTypeInfo
    • BatchStatus
    • PaymentDatesInfo
    • Case
    • PaymentAmountsInfo
    • CaseInvoiceExtended
    • AllocatedPaymentTransactionsMeta
    • 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
Need help?
  1. Invoice Service

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: ********************
or
Body Params application/json

Examples

Responses

🟢202
application/json
Accepted
Bodyapplication/json

🟠400
🟠401
Request Request Example
Shell
JavaScript
Java
Swift
curl --location '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": 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 Response Example
202 - Example 1
{
    "StatusDescription": "string",
    "UploadedInvoicesCount": 0,
    "FailedInvoicesCount": 0,
    "FailedInvoices": "string"
}
Previous
Create an invoice
Next
Submit a batch of sales invoices
Built with