Consultar CUI en RENAP
Consulta los datos de una persona por CUI/DPI en RENAP (vía el certificador), incluyendo el indicador de fallecido. Requiere scope `invoices:read` (API key) o JWT. Si el servicio de consulta no está configurado en el ambiente, responde 503 LOOKUP_UNAVAILABLE.
Authorization
ApiKeyAuth API key con prefijo qapi_live_ o qapi_test_, o JWT (access_token) obtenido vía POST /v1/auth/login. QAPI detecta el tipo automáticamente por el prefijo del token.
In: header
Path Parameters
CUI/DPI a consultar: exactamente 13 dígitos.
Response Body
application/json
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/v1/receptores/cui/2059473012005"{
"cui": "2059473012005",
"nombre": "JUAN PEREZ LOPEZ",
"direccion": "CIUDAD",
"fallecido": false
}{
"type": "https://docs.dtevia.com.gt/errors/validation-error",
"title": "VALIDATION_ERROR",
"status": 422,
"detail": "Error de validación",
"instance": "/v1/invoices",
"invalid_params": [
{
"field": "items.0.impuestos.0.monto_impuesto",
"message": "MontoImpuesto IVA inválido. Esperado ~12 (MontoGravable 100 × 0.12), recibido 10"
}
]
}{
"type": "https://docs.dtevia.com.gt/errors/validation-error",
"title": "VALIDATION_ERROR",
"status": 422,
"detail": "Error de validación",
"instance": "/v1/invoices",
"invalid_params": [
{
"field": "items.0.impuestos.0.monto_impuesto",
"message": "MontoImpuesto IVA inválido. Esperado ~12 (MontoGravable 100 × 0.12), recibido 10"
}
]
}{
"type": "https://docs.dtevia.com.gt/errors/validation-error",
"title": "VALIDATION_ERROR",
"status": 422,
"detail": "Error de validación",
"instance": "/v1/invoices",
"invalid_params": [
{
"field": "items.0.impuestos.0.monto_impuesto",
"message": "MontoImpuesto IVA inválido. Esperado ~12 (MontoGravable 100 × 0.12), recibido 10"
}
]
}{
"type": "https://docs.dtevia.com.gt/errors/validation-error",
"title": "VALIDATION_ERROR",
"status": 422,
"detail": "Error de validación",
"instance": "/v1/invoices",
"invalid_params": [
{
"field": "items.0.impuestos.0.monto_impuesto",
"message": "MontoImpuesto IVA inválido. Esperado ~12 (MontoGravable 100 × 0.12), recibido 10"
}
]
}Consultar NIT en SAT
Consulta los datos de un contribuyente en el padrón de SAT (vía el certificador) para pre-llenar o validar el receptor antes de emitir. Requiere scope `invoices:read` (API key) o JWT. Si el servicio de consulta no está configurado en el ambiente, responde 503 LOOKUP_UNAVAILABLE — tratalo como opcional: siempre podés enviar el nombre del receptor manualmente.
Historial del sandbox (hoy)
Devuelve las facturas de prueba creadas HOY (hora de Guatemala), de más reciente a más antigua. Para el detalle completo de una factura usá GET /v1/invoices/{id}.