1. Resources
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
      GET
    • Renew token
      GET
  • Collection endpoints
    • Create Collection Cases
      POST
    • Update Collection Receivables
      POST
    • Retrieve Collection Receivables Status
      GET
    • Retrieve Case Batch Status
      GET
    • Retrieve collection case
      GET
    • Retrieve debtor summary
      GET
    • Retrieve list of settlements
      GET
    • Retrieve settlement data
      GET
    • Retrieve list of direct settlements
      GET
    • Retrieve direct settlement data
      GET
    • Retrieve Credit Loss Receivables
      GET
    • Retrieve allocated payment transactions
      GET
  • Invoice endpoints
    • Invoice Service
      • Create an invoice
      • Create an invoice with seller information
      • Submit a batch of sales invoices
      • List batch uploads and export lines
      • List all sales invoices
      • Retrieve invoice delivery information
      • Retrieve invoice status
      • Update an invoice
      • Submit payment for an invoice
      • Retrieve delivery statistics
      • Retrieve received payments
      • Submit update to Finvoice Account
      • Retrieve electronic invoicing contracts
    • 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. Resources

Print & Distribution service

The Cash-In Print and Distribution (CIPD) service is the operational backbone responsible for the physical and electronic delivery of invoices generated within the invoicing ecosystem.
CIPD is the service that takes care of getting invoices to their recipients. Once an invoice has been validated, CIPD formats it according to the client's settings, generates a print-ready PDF, and sends it through the right delivery channel.
Delivery methods
CIPD supports a broad range of delivery methods:
CIPD_Delivery_Methods.png
Distribution partners
CIPD operates across distribution partner networks in Finland, Sweden, and Norway, working with distributors including Posti, PostNord Strålfors, and TietoEvry.
CIPD_Distribution_Partners.png

Relationship to the Invoice Intermediation Service#

CIPD operates downstream of the Invoice Intermediation Service, which governs how an invoice is classified and what lifecycle handling it will receive.
The Intermediation Service defines one of two service modes:
Invoice Intermediation — The invoice is delivered to the recipient with no further handling. CIPD fulfils the distribution and the process ends upon successful delivery acknowledgement.
Invoice Lifecycle — After CIPD delivers the invoice, the invoice is also transferred to payment monitoring by the Cash-In agency, which takes over responsibility for tracking payment status, sending reminders, and managing overdue processing.
The Invoice Intermediation Service defines what type of service the invoice requires. CIPD then takes care of the actual delivery — formatting the invoice, generating the PDF, and sending it through the right channel to the recipient.

Postal address information#

For invoices sent by post, a valid postal address is required in the invoice data before CIPD can process the delivery. This includes a correctly formatted postal code — if the postal code is missing or invalid, the invoice cannot be dispatched to the recipient, and it will also be blocked from transferring to payment monitoring.
This means that an address error does not only delay delivery — it stops the entire invoice lifecycle in its tracks. The invoice will remain undelivered and unmonitored until the address data has been corrected in the source system and the invoice is resubmitted.
To avoid this, always ensure that the postal address — including a valid postal code — is complete and correct before the invoice is created.
Postal address is required on all invoices
Every invoice must include a complete postal address, regardless of delivery method. This applies to email, EDI, Kivra, and Omaposti deliveries as well as postal letters. A missing or invalid postal code will prevent the invoice from being delivered and will block it from entering payment monitoring.

Data Sources#

All invoice data originates from the central invoice service repository.
Data enters the system through three primary sources:
EDI data feeds — structured electronic invoice data from external systems
API integrations — programmatic invoice generation via the Cash-In API
Online Invoice Service — invoices created directly through the web-based invoicing interface.
Each source feeds into the validation pipeline before invoices are eligible for CIPD processing.

Process flow#

0f569497-9148-4446-8869-c7c359a5381e.png
Print & Distribution Service flow
Previous
Cash-In Client Portal
Next
Confirma Software Partner services
Built with