Listar Doc. Soporte
Este endpoint devuelve una lista de documentos soporte 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/support-documents?filter[identification]&filter[names]&filter[number]&filter[prefix]&filter[reference_code]&filter[status]https://api.factus.com.co/v2/support-documents?filter[identification]&filter[names]&filter[number]&filter[prefix]&filter[reference_code]&filter[status]Encabezados 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 proveedor. |
filter[names] integer Filtra por el nombre del proveedor. |
filter[number] integer Filtra por el número de documento soporte. |
filter[prefix] integer Filtra por el prefijo de rango de numeración. |
filter[reference_code] integer Filtra por código de referencia. |
filter[status] integer Filtra por el estado del documento. 1 = validado, 0 si no esta validado. |
Respuesta del Endpoint
Sección titulada «Respuesta del Endpoint»{ "status": "OK", "message": "Solicitud exitosa", "data": { "data": [ { "api_client_name": "test-oscar", "number": "SEDS984000001", "reference_code": "2a4b0f73-043a-43d1-bfdf-ad6777bd8158", "provider": { "identification_document": { "code": "31", "name": "NIT" }, "identification": "2343543", "dv": "7", "trade_name": null, "names": "Pepito Perez", "address": "calle 4", "email": null, "phone": null, "legal_organization": { "code": "2", "name": "Persona Natural" }, "municipality": { "code": "68679", "name": "San Gil", "department": { "code": "68", "name": "Santander" } } }, "total": "80000.00", "errors": [ "Regla: RUT01, Notificación: La validación del estado del RUT próximamente estará disponible." ], "send_email": false, "is_validated": true, "validated_at": "05-05-2026 11:42:05 AM", "created_at": "05-05-2026 11:40:00 AM", "adjustment_notes": [] }, { "api_client_name": "test-oscar", "number": "SEDS984000002", "reference_code": "969d69b3-105f-4ad0-9314-dc353f1bec11", "provider": { "identification_document": { "code": "31", "name": "NIT" }, "identification": "2343543", "dv": "7", "trade_name": null, "names": "Pepito Perez", "address": "calle 4", "email": null, "phone": null, "legal_organization": { "code": "2", "name": "Persona Natural" }, "municipality": { "code": "68679", "name": "San Gil", "department": { "code": "68", "name": "Santander" } } }, "total": "80000.00", "errors": [ "Regla: RUT01, Notificación: La validación del estado del RUT próximamente estará disponible." ], "send_email": false, "is_validated": true, "validated_at": "05-05-2026 11:42:18 AM", "created_at": "05-05-2026 11:40:00 AM", "adjustment_notes": [] }, { "api_client_name": "test-oscar", "number": "SEDS984000003", "reference_code": "f2e681aa-d244-4b2a-99a4-0d8de434cfb7", "provider": { "identification_document": { "code": "31", "name": "NIT" }, "identification": "2343543", "dv": "7", "trade_name": null, "names": "Alan Turing", "address": "calle 4", "email": null, "phone": null, "legal_organization": { "code": "2", "name": "Persona Natural" }, "municipality": { "code": "68679", "name": "San Gil", "department": { "code": "68", "name": "Santander" } } }, "total": "80000.00", "errors": [ "Regla: RUT01, Notificación: La validación del estado del RUT próximamente estará disponible." ], "send_email": false, "is_validated": true, "validated_at": "05-05-2026 11:46:43 AM", "created_at": "05-05-2026 11:40:00 AM", "adjustment_notes": [] }, { "api_client_name": "Factus", "number": "SEDS984000000", "reference_code": "c22ae7cd-2c32-4bbd-be06-0691737d2462", "provider": { "identification_document": { "code": "31", "name": "NIT" }, "identification": "1100970785", "dv": "8", "trade_name": null, "names": "Ivan Aparicio", "address": "calle 11 # 8 - 84", "email": "ivan@tudominio.com", "phone": null, "legal_organization": { "code": "2", "name": "Persona Natural" }, "municipality": { "code": "68679", "name": "San Gil", "department": { "code": "68", "name": "Santander" } } }, "total": "1250000.00", "errors": [ "Regla: RUT01, Notificación: La validación del estado del RUT próximamente estará disponible." ], "send_email": false, "is_validated": true, "validated_at": "05-05-2026 09:42:16 AM", "created_at": "05-05-2026 09:42:13 AM", "adjustment_notes": [] } ], "pagination": { "total": 4, "per_page": 10, "current_page": 1, "last_page": 1, "from": 1, "to": 4, "links": [ { "url": null, "label": "« Anterior", "active": false }, { "url": "https://api-sandbox.factus.com.co/v2/support-documents?page=1", "label": 1, "active": true, "page": 1 }, { "url": null, "label": "Siguiente »", "active": false, "page": 2 } ] } }}El endpoint devuelve información paginada de los documentos soporte, incluyendo:
- Total: Total de los documentos soporte.
- 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.