ES | EN

📄 MIPYME Documents

Get a paginated list of documents

GET
URL del endpoint https://api-billing.koywe.com/V1/documents
Requiere autenticación

Autenticación

Envía la cabecera Authorization: Bearer <token> (obtenido en POST /auth) en los endpoints protegidos.

Parámetros

NombreUbicaciónTipoRequeridoDescripción
pagequeryinteger
per_pagequeryinteger
issue_date_fromquerystringFilter from this date (inclusive). Format AAAA-MM-DD
issue_date_toquerystringFilter to this date (inclusive). Format AAAA-MM-DD
taxbureau_sending_statusqueryinteger0 = Sending. \ 1XX = Retrying sending. \ 2XX = Rejected by Tax Bureau. \ 1 = Received by Tax Bureau. \ 2 = Closed without sending. \ 3 = Imported from another system.
taxbureau_validation_statusqueryinteger0,1 = In process. \ 2 = Sending rejected by tax bureau. \ 3 = Accepted by tax bureau. \ 4 = Accepted by tax bureau with warnings. \ 5 = Content Rejected by tax bureau.
document_numberquerystringDocument number
document_type_idqueryintegerDocument type ID according to the country
received_issued_flagquerynumber0 = issued \ 1 = received
receiver_tax_id_codequerystringReceiver document number
receiver_legal_namequerystringFilter to search by the receiver company's name in the document.
min_total_amountquerystringFilter that allows searching with a minimum of total_amount and also supports using both filters together.
max_total_amountquerystringFilter that allows searching with a maximum of total_amount and also supports using both filters together.
reference_document_idqueryintegerFilter that allows searching by reference document ID.
reference_codequeryintegerFilter that allows searching by reference code. 1 = cancel, 2 = correct text, 3 = correct quantity, 4 = set, 5 = reference to other non-tax documents, 6 = reference to dispatch guide, 7 = global reference to a type of document (allows reducing the amount for all documents of this type for this particular client).
reference_numberquerystringFilter that allows searching by reference number ONLY for non-tax documents, for tax documents, use the reference_document_id parameter
reference_typequerystringFilter that allows searching by reference type. This is the document type ONLY for non-tax documents, for tax documents, use the reference_document_id parameter.
order_byquerystringasc = ascending\ desc = descending\ Filter based on the date, which can also be combined with another parameter.
document_statusqueryinteger0 = Draft\ 1 = Issued\ 2 = Cancelled (mexico)\ Filter based on the document_status: draft, issued or cancelled.

Respuestas

200 Successful response