iFirma API

14 endpoints for iFirma, each at its own method and path, called with your API key. Open an endpoint for its inputs, examples and response.

Base URL: https://cotlet.dev/api/v1/ifirma
Connects with: Your own iFirma account (the account holder; sales, KSeF and expenses must be part of your package)
Integration page: iFirma

Read (5)

Return data and change nothing in the account.

iFirma Endpoints: Read
Endpoint	Description
GET /invoices	Sales invoices for a date range, with totals, payment and KSeF status.
GET /invoices/{invoice_id}	One invoice with its lines, buyer, payments and KSeF status.
GET /invoices/{invoice_id}/pdf	The invoice as a PDF file, base64 encoded.
GET /contractors	Contractors from your list, searchable by name or tax number.
GET /ksef-purchase-invoices	Invoices that suppliers sent to you in KSeF and you have not booked yet.

Change the account. Calls marked Confirm wait for the user to approve them.

iFirma Endpoints: Write
Endpoint	Description
POST /postals/{postal_code}/contractors	Add a contractor to your iFirma list.
POST /contractors/{contractor_id}/invoice-draft/save	Save an invoice as a draft without a number, to review and issue in the app.
POST /contractors/{contractor_id}/invoices Confirm	Issue a domestic invoice for a contractor with one or more lines.
POST /invoices/{invoice_id}/to-ksef Confirm	Send one issued invoice to the Polish KSeF e-invoicing system.
POST /invoices/{invoice_id}/email Confirm	Email an issued invoice to the buyer, with the invoice attached.
POST /invoices/{invoice_id}/payments Confirm	Record a payment received on an invoice.
POST /ksefs/{ksef_number}/purchase-invoice Confirm	Book a purchase invoice from KSeF as a cost.
POST /invoices/{invoice_number}/expenses Confirm	Add a cost document by hand: goods purchase, business cost or phone and internet bill.
POST /invoices/{invoice_id}/payment-reminders Confirm	Email a Ponaglenie, Monit or Wezwanie do zapłaty for an unpaid invoice.