General

Las operaciones de General de la API de Trevol: parámetros, cuerpo, respuestas y ejemplos de código.

Salud, la empresa de la llave y la consulta de adquirientes.

Los ejemplos son peticiones con cURL. La llave va en TREVOL_API_KEY; los cuerpos de ejemplo son los de la especificación. Los errores comunes están en Errores.

Salud

GET /v1/health · getHealth

Respuestas

Estado	Qué pasó
200	ok

GET /v1/health

cURL

curl "https://api.trevol.si/v1/health" \
  -H "Authorization: Bearer $TREVOL_API_KEY"

La empresa de la llave

GET /v1/company · retrieveCompany

La empresa de la llave: NIT, razón social, ambiente y numeraciones activas. Desde la fase 3 trae capabilities, un resumen de lo que ESTA llave puede emitir ahora: documento soporte (con su numeración), documento equivalente (con los prefijos POS), nómina (status: enabled, testing, not_registered o not_enabled, según el ambiente de la llave) y eventos RADIAN (representante legal). Es informativo: si una lectura falla, esa clave no aparece.

Respuestas

Estado	Qué pasó
200	La empresa, su ambiente y sus numeraciones activas (Company)
Error	Error (application/problem+json) (Problem)

GET /v1/company

cURL

curl "https://api.trevol.si/v1/company" \
  -H "Authorization: Bearer $TREVOL_API_KEY"

Probar en el Playground

Datos del adquiriente en la DIAN

GET /v1/dian/acquirer · retrieveDianAcquirer

Parámetros

document_typeconsultatextoobligatorio
document_numberconsultatextoobligatorio

Respuestas

Estado	Qué pasó
200	{found, name, email} (Acquirer)
Error	Error (application/problem+json) (Problem)

GET /v1/dian/acquirer

cURL

curl "https://api.trevol.si/v1/dian/acquirer?document_type=31&document_number=900373591" \
  -H "Authorization: Bearer $TREVOL_API_KEY"

Probar en el Playground