API Reference

Create an invoice draft

post
https://api.getkivly.com/api/v1/invoices/drafts

Create a draft without consuming an invoice number. Amounts are major currency units (12.50 = EUR 12.50), unlike loyalty sale amounts. No fiscal submission occurs until issue. The issuer must be assigned to this business/branch in the Dashboard.

Integration access is restricted to the credential's location. Pagination, monetary units and response envelopes are endpoint-specific; use the schema below. Do not assume that POST/PATCH requests are safe to retry after a timeout.

Recent Requests
Log in to see full request history
TimeStatusUser Agent
Retrieving recent requests…
LoadingLoading…
Body Params

Factura ajena al TPV: se crea como borrador y se emite aparte.

Los dos pasos están separados porque emitir es irreversible. Una factura
escrita a mano se teclea, se revisa y luego consume número; crearla ya
emitida convertiría cada error de tecleo en una rectificativa.

string
required
customerCompany
object
required

Datos del cliente (empresa o particular).

postal_code va aparte de address porque hay administraciones que lo piden
separado: TicketBAI tiene CodigoPostal y Direccion como dos elementos, y
en Gipuzkoa y Araba una factura con destinatario identificado y sin
dirección se rechaza. Es opcional para no invalidar las facturas ya
emitidas; cuando falta se intenta leer de address, y si no se puede leer con
seguridad se pide, en vez de adivinarlo: un código postal inventado viaja a
la hacienda foral igual que uno correcto.

items
array of objects
Items
Responses

Updated about 20 hours ago

Did this page help you?
Language
Credentials
Bearer
JWT
LoadingLoading…
Response
Click Try It! to start a request and see the response here! Or choose an example:
application/json

Updated about 20 hours ago

Did this page help you?