​
Invoice Inbox Guide

This guide covers everything you need to know about managing received invoices in your E-Invoicing inbox. The Invoice Inbox API allows you to retrieve, view, and download invoices that have been sent to your business by other taxpayers.

​
Get Inbox Invoices

Retrieve a list of all invoices received by your business with filtering and pagination options.

​
Get Specific Inbox Invoice

Retrieve detailed information about a specific invoice received in your inbox.

​
Download Inbox Invoice

Retrieve the complete invoice data for a received invoice in JSON format.
The response contains the complete invoice data in JSON format, including all invoice details, line items, tax information, and party details. This data can be used for processing, analysis, or integration with your business systems.

​
Payment Status Filtering

  • PENDING: Invoices awaiting payment
  • PAID: Invoices that have been paid
  • REJECTED: Invoices that have been rejected

​
Date Filtering

  • issue_date: Filter by the date the invoice was issued
  • due_date: Filter by the payment due date

​
Advanced Filtering

  • irn: Search by specific Invoice Reference Number
  • invoice_type_code: Filter by invoice type (e.g., 380 for commercial invoice)
  • tax_currency_code: Filter by tax currency
  • document_currency_code: Filter by document currency

​
Common Use Cases

​
1. Invoice Processing Workflow

  1. Retrieve inbox invoices with PENDING status
  2. Review invoice details
  3. Retrieve complete invoice data for processing
  4. Update payment status when payment is made

​
2. Payment Reconciliation

  1. Filter invoices by payment status
  2. Match invoices with payment records
  3. Update payment status accordingly
  4. Generate reconciliation reports

​
3. Compliance Monitoring

  1. Monitor invoice delivery and transmission status
  2. Track payment compliance
  3. Generate compliance reports
  4. Maintain audit trails

​
Next Steps

Now that you understand invoice inbox operations, explore these related topics:
Always ensure proper validation and error handling in your implementation. The Invoice Inbox API is essential for managing received invoices and maintaining compliance with e-invoicing regulations. Regular monitoring and timely processing of received invoices are crucial for successful e-invoicing operations.