Consultar el contribuyente emisor
Devuelve los datos del contribuyente identificado por la API key, tal como se usan al emitir en el ambiente de la clave: datos fiscales, dirección, timbrado, establecimientos y el estado de la configuración necesaria para emitir.
estadoConfiguracion.listoParaEmitir reproduce los controles que la emisión
hace antes de asignar número. No contempla el cupo del plan, que se consulta en
GET /api/v1/contribuyente/plan-consumo. En SANDBOX el timbrado y el
CSC de prueba se generan en la primera emisión y la vigencia del certificado no
se exige.
Authorization
apiKey API key de Sifende en el header Authorization: Bearer {api-key}.
Además de autenticar, fija el contribuyente emisor y un ambiente inmutable DEV, PROD o
SANDBOX: por eso ninguno de los dos se envía en el body.
En PROD, la clave requiere un plan que incluya la API de integración; si no, toda ruta
responde 403 plan-operation-not-allowed.
In: header
Response Body
application/json
application/json
application/problem+json
curl -X GET "https://example.com/api/v1/contribuyente"personaJuridica
{ "ruc": "80012345", "digitoVerificador": "1", "razonSocial": "Ejemplo S.A.", "nombreFantasia": "Ejemplo", "tipoContribuyente": "PERSONA_JURIDICA", "ambiente": "PROD", "actividadesEconomicas": [ { "codigo": "56101", "descripcion": "Restaurantes" } ], "direccion": "Av. Mcal. López", "numeroCasa": 1234, "departamento": { "codigo": 1, "descripcion": "CAPITAL" }, "distrito": { "codigo": 1, "descripcion": "ASUNCION (DISTRITO)" }, "ciudad": { "codigo": 1, "descripcion": "ASUNCION (DISTRITO)" }, "telefono": "021123456", "email": "[email protected]", "timbrado": { "numero": 12345678, "fechaInicioVigencia": "2026-01-15" }, "establecimientos": [ { "numeroEstablecimiento": 1, "nombreSucursal": "Casa central", "activo": true, "puntosExpedicion": [ { "puntoExpedicion": 1, "activo": true } ] } ], "logoUrl": "https://storage.googleapis.com/sifende-assets/logos/112/3f0c8f5e-6b2a-4d7e-9a51-2c4e8b7d9f10.png", "estadoConfiguracion": { "certificadoConfigurado": true, "certificadoVence": "2027-03-01", "certificadoVigente": true, "cscConfigurado": true, "timbradoVigente": true, "direccionConfigurada": true, "actividadEconomicaConfigurada": true, "listoParaEmitir": true }}