Listar facturas
Este endpoint devuelve una lista de facturas que cumplen con los criterios de búsqueda especificados en los
filtros de búsqueda descritos abajo.
Método: GET
Endpoint
https://api-sandbox.factus.com.co/v2/billshttps://api.factus.com.co/v2/billsEncabezados de la Solicitud
Para realizar la solicitud es necesario incluir los siguientes encabezados:
Content-Type : application/json Indica que los datos se envían en formato JSON. |
Authorization Bearer token_de_acceso Token de autenticación necesario para acceder al recurso. Ver Cómo generar token |
Accept : application/json Indica que la respuesta debe estar en formato JSON. |
Nota:
Reemplaza token_de_acceso con el token proporcionado tras autenticarte.
Filtros de Búsqueda
Sección titulada «Filtros de Búsqueda»filter[identification] Filtra por el número de identificación del cliente. |
filter[names] integer Filtra por el nombre del cliente. |
filter[number] integer Filtra por el número de factura. |
filter[prefix] integer Filtra por el prefijo de factura. |
filter[reference_code] integer Filtra por código de referencia. |
filter[status] integer Filtra por el estado del la factura (1=validada, 0= pendiente por validar). |
Respuesta del Endpoint
Sección titulada «Respuesta del Endpoint»{ "status": "OK", "message": "Solicitud exitosa", "data": { "data": [ { "api_client_name": "comoslab current", "number": "SETP990001111", "document": { "code": "01", "name": "Factura electrónica de Venta" }, "operation_type": { "code": "10", "name": "Estándar" }, "payment_form": { "code": "1", "name": "Pago de contado" }, "reference_code": "FACT-2026-0132", "customer": { "identification_document": { "code": "31", "name": "NIT" }, "identification": "123456789", "dv": "6", "graphic_representation_name": "Alan trade name", "trade_name": "Alan trade name", "company": "Alan company name", "names": null, "address": "calle 1 # 1-1", "email": "alan.company@email.com", "phone": "1234567890", "legal_organization": { "code": "1", "name": "Persona Jurídica" }, "municipality": { "code": "68679", "name": "San Gil", "department": { "code": "68", "name": "Santander" } } }, "total": "1000000.00", "errors": null, "send_email": false, "has_claim": false, "is_negotiable_instrument": false, "is_validated": true, "validated_at": "02-03-2026 03:24:52 PM", "created_at": "02-03-2026 03:24:50 PM", "credit_notes": [], "debit_notes": [] }, { "api_client_name": "comoslab current", "number": "SETP990001110", "document": { "code": "01", "name": "Factura electrónica de Venta" }, "operation_type": { "code": "10", "name": "Estándar" }, "payment_form": { "code": "1", "name": "Pago de contado" }, "reference_code": "FACT-2026-0131", "customer": { "identification_document": { "code": "31", "name": "NIT" }, "identification": "123456789", "dv": "6", "graphic_representation_name": "Alan trade name", "trade_name": "Alan trade name", "company": "Alan company name", "names": null, "address": "calle 1 # 1-1", "email": "alan.company@email.com", "phone": "1234567890", "legal_organization": { "code": "1", "name": "Persona Jurídica" }, "municipality": { "code": "68679", "name": "San Gil", "department": { "code": "68", "name": "Santander" } } }, "total": "1190000.00", "errors": null, "send_email": false, "has_claim": false, "is_negotiable_instrument": false, "is_validated": true, "validated_at": "02-03-2026 03:07:07 PM", "created_at": "02-03-2026 03:07:06 PM", "credit_notes": [], "debit_notes": [] }, { "api_client_name": "comoslab current", "number": "SETP990001109", "document": { "code": "01", "name": "Factura electrónica de Venta" }, "operation_type": { "code": "10", "name": "Estándar" }, "payment_form": { "code": "2", "name": "Pago a crédito" }, "reference_code": "FACT-2026-0130", "customer": { "identification_document": { "code": "31", "name": "NIT" }, "identification": "123456789", "dv": "6", "graphic_representation_name": "Alan trade name", "trade_name": "Alan trade name", "company": "Alan company name", "names": null, "address": "calle 1 # 1-1", "email": "alan.company@email.com", "phone": "1234567890", "legal_organization": { "code": "1", "name": "Persona Jurídica" }, "municipality": { "code": "68679", "name": "San Gil", "department": { "code": "68", "name": "Santander" } } }, "total": "83300.00", "errors": null, "send_email": false, "has_claim": false, "is_negotiable_instrument": false, "is_validated": true, "validated_at": "02-03-2026 02:53:57 PM", "created_at": "02-03-2026 02:53:56 PM", "credit_notes": [], "debit_notes": [] }, { "api_client_name": "comoslab current", "number": "SETP990001108", "document": { "code": "01", "name": "Factura electrónica de Venta" }, "operation_type": { "code": "10", "name": "Estándar" }, "payment_form": { "code": "1", "name": "Pago de contado" }, "reference_code": "FACT-2026-0129", "customer": { "identification_document": { "code": "31", "name": "NIT" }, "identification": "123456789", "dv": "6", "graphic_representation_name": "Alan trade name", "trade_name": "Alan trade name", "company": "Alan company name", "names": null, "address": "calle 1 # 1-1", "email": "alan.company@email.com", "phone": "1234567890", "legal_organization": { "code": "1", "name": "Persona Jurídica" }, "municipality": { "code": "68679", "name": "San Gil", "department": { "code": "68", "name": "Santander" } } }, "total": "85300.00", "errors": { "FAQ04a": "Regla: FAQ04a, Notificación: La descripción informada no corresponde al código informado" }, "send_email": false, "has_claim": false, "is_negotiable_instrument": false, "is_validated": true, "validated_at": "02-03-2026 02:46:02 PM", "created_at": "02-03-2026 02:46:00 PM", "credit_notes": [], "debit_notes": [] }, { "api_client_name": "comoslab current", "number": "SETP990001107", "document": { "code": "01", "name": "Factura electrónica de Venta" }, "operation_type": { "code": "10", "name": "Estándar" }, "payment_form": { "code": "2", "name": "Pago a crédito" }, "reference_code": "FACT-2026-0128", "customer": { "identification_document": { "code": "31", "name": "NIT" }, "identification": "123456789", "dv": "6", "graphic_representation_name": "Alan trade name", "trade_name": "Alan trade name", "company": "Alan company name", "names": null, "address": "calle 1 # 1-1", "email": "alan.company@email.com", "phone": "1234567890", "legal_organization": { "code": "1", "name": "Persona Jurídica" }, "municipality": { "code": "68679", "name": "San Gil", "department": { "code": "68", "name": "Santander" } } }, "total": "83300.00", "errors": null, "send_email": false, "has_claim": false, "is_negotiable_instrument": false, "is_validated": true, "validated_at": "02-03-2026 02:29:19 PM", "created_at": "02-03-2026 02:29:18 PM", "credit_notes": [], "debit_notes": [] }, { "api_client_name": "comoslab current", "number": "SETP990001106", "document": { "code": "01", "name": "Factura electrónica de Venta" }, "operation_type": { "code": "10", "name": "Estándar" }, "payment_form": { "code": "1", "name": "Pago de contado" }, "reference_code": "FACT-2026-0127", "customer": { "identification_document": { "code": "31", "name": "NIT" }, "identification": "123456789", "dv": "6", "graphic_representation_name": "Alan trade name", "trade_name": "Alan trade name", "company": "Alan company name", "names": null, "address": "calle 1 # 1-1", "email": "alan.company@email.com", "phone": "1234567890", "legal_organization": { "code": "1", "name": "Persona Jurídica" }, "municipality": { "code": "68679", "name": "San Gil", "department": { "code": "68", "name": "Santander" } } }, "total": "83300.00", "errors": null, "send_email": false, "has_claim": false, "is_negotiable_instrument": false, "is_validated": true, "validated_at": "02-03-2026 02:22:15 PM", "created_at": "02-03-2026 02:22:14 PM", "credit_notes": [], "debit_notes": [] }, { "api_client_name": "comoslab current", "number": "SETP990001105", "document": { "code": "01", "name": "Factura electrónica de Venta" }, "operation_type": { "code": "12", "name": "Transporte" }, "payment_form": { "code": "1", "name": "Pago de contado" }, "reference_code": "FACT-2026-0126", "customer": { "identification_document": { "code": "31", "name": "NIT" }, "identification": "123456789", "dv": "6", "graphic_representation_name": "Alan trade name", "trade_name": "Alan trade name", "company": "Alan company name", "names": null, "address": "calle 1 # 1-1", "email": "alan.company@email.com", "phone": "1234567890", "legal_organization": { "code": "1", "name": "Persona Jurídica" }, "municipality": { "code": "68679", "name": "San Gil", "department": { "code": "68", "name": "Santander" } } }, "total": "2400000.00", "errors": { "FBF02": "Regla: FBF02, Notificación: Característica específica del ítem no informado" }, "send_email": false, "has_claim": false, "is_negotiable_instrument": false, "is_validated": true, "validated_at": "02-03-2026 11:43:09 AM", "created_at": "02-03-2026 11:43:07 AM", "credit_notes": [], "debit_notes": [] }, { "api_client_name": "comoslab current", "number": "SETP990001104", "document": { "code": "01", "name": "Factura electrónica de Venta" }, "operation_type": { "code": "11", "name": "Mandato" }, "payment_form": { "code": "1", "name": "Pago de contado" }, "reference_code": "FACT-2026-0125", "customer": { "identification_document": { "code": "31", "name": "NIT" }, "identification": "123456789", "dv": "6", "graphic_representation_name": "Alan trade name", "trade_name": "Alan trade name", "company": "Alan company name", "names": null, "address": "calle 1 # 1-1", "email": "alan.company@email.com", "phone": "1234567890", "legal_organization": { "code": "1", "name": "Persona Jurídica" }, "municipality": { "code": "68679", "name": "San Gil", "department": { "code": "68", "name": "Santander" } } }, "total": "17850.00", "errors": null, "send_email": false, "has_claim": false, "is_negotiable_instrument": false, "is_validated": true, "validated_at": "02-03-2026 11:23:41 AM", "created_at": "02-03-2026 11:23:40 AM", "credit_notes": [], "debit_notes": [] }, { "api_client_name": "comoslab current", "number": "SETP990001103", "document": { "code": "01", "name": "Factura electrónica de Venta" }, "operation_type": { "code": "10", "name": "Estándar" }, "payment_form": { "code": "1", "name": "Pago de contado" }, "reference_code": "FACT-2026-0124", "customer": { "identification_document": { "code": "31", "name": "NIT" }, "identification": "123456789", "dv": "6", "graphic_representation_name": "Alan trade name", "trade_name": "Alan trade name", "company": "Alan company name", "names": null, "address": "calle 1 # 1-1", "email": "alan.company@email.com", "phone": "1234567890", "legal_organization": { "code": "1", "name": "Persona Jurídica" }, "municipality": { "code": "68679", "name": "San Gil", "department": { "code": "68", "name": "Santander" } } }, "total": "83300.00", "errors": null, "send_email": false, "has_claim": false, "is_negotiable_instrument": false, "is_validated": true, "validated_at": "02-03-2026 11:12:48 AM", "created_at": "02-03-2026 11:12:47 AM", "credit_notes": [], "debit_notes": [] }, { "api_client_name": "comoslab current", "number": "SETP990001102", "document": { "code": "01", "name": "Factura electrónica de Venta" }, "operation_type": { "code": "11", "name": "Mandato" }, "payment_form": { "code": "1", "name": "Pago de contado" }, "reference_code": "FACT-2026-0123", "customer": { "identification_document": { "code": "13", "name": "Cédula ciudadanía" }, "identification": "123456789", "dv": null, "graphic_representation_name": "Alan name", "trade_name": null, "company": null, "names": "Alan name", "address": "No informado", "email": null, "phone": null, "legal_organization": { "code": "2", "name": "Persona Natural" }, "municipality": null }, "total": "17850.00", "errors": null, "send_email": false, "has_claim": false, "is_negotiable_instrument": false, "is_validated": true, "validated_at": "02-03-2026 10:56:12 AM", "created_at": "02-03-2026 10:56:11 AM", "credit_notes": [], "debit_notes": [] } ], "pagination": { "total": 1023, "per_page": 10, "current_page": 1, "last_page": 103, "from": 1, "to": 10, "links": [ { "url": null, "label": "« Anterior", "active": false }, { "url": "http://api.test/v2/bills?page=1", "label": 1, "active": true, "page": 1 }, { "url": "http://api.test/v2/bills?page=2", "label": 2, "active": false, "page": 2 }, { "url": "http://api.test/v2/bills?page=3", "label": 3, "active": false, "page": 3 }, { "url": "http://api.test/v2/bills?page=4", "label": 4, "active": false, "page": 4 }, { "url": null, "label": "...", "active": false }, { "url": "http://api.test/v2/bills?page=103", "label": 103, "active": false, "page": 103 }, { "url": "http://api.test/v2/bills?page=2", "label": "Siguiente »", "active": false, "page": 2 } ] } }}El endpoint devuelve información paginada de las facturas, incluyendo:
- Total: Total de las facturas.
- Por página: 10 resultados por página.
- Página actual: Página en la que se encuentra.
- Última página: Última página disponible.
- Desde: Índice inicial de los resultados.
- Hasta: Índice final de los resultados.
- Links: Navegación entre las páginas del endpoint.
Para navegar entre las páginas, utilice el parámetro de consulta page y especifique el número de página deseado.
Si el número de página no existe, el objeto data estará vacío.