Sifende
Referencia APIExplorador de la API

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 el certificado no se exige: sin uno activo, se firma con uno de prueba.

GET
/api/v1/contribuyente
AuthorizationBearer <token>

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, salvo las bajas: revocar la propia clave (DELETE /api/v1/contribuyente/api-key) y eliminar un webhook.

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": "facturacion@ejemplo.com.py",  "timbrado": {    "numero": 12345678,    "fechaInicioVigencia": "2026-01-15"  },  "establecimientos": [    {      "numeroEstablecimiento": 1,      "nombreSucursal": "Casa central",      "activo": true,      "puntosExpedicion": [        {          "puntoExpedicion": 1,          "activo": true        }      ]    }  ],  "logoUrl": "https://example.com/logo.png",  "estadoConfiguracion": {    "certificadoConfigurado": true,    "certificadoVence": "2027-03-01",    "certificadoVigente": true,    "cscConfigurado": true,    "timbradoVigente": true,    "direccionConfigurada": true,    "actividadEconomicaConfigurada": true,    "listoParaEmitir": true  }}

Usamos cookies necesarias para que el sitio funcione. Con tu permiso, también usamos herramientas de analítica para entender cómo se usa el sitio y para medir nuestras campañas publicitarias. Política de privacidad