Referencia APIModelos de Datos
Receptor
Schema del objeto receptor — datos del destinatario del documento para operaciones B2B, B2C, B2G y B2F.
El objeto receptor identifica al destinatario del documento electrónico. Su estructura cambia según el tipo de operación: B2C (consumidor final), B2B (otro contribuyente con RUC), B2G (organismo público) o B2F (cliente del exterior).
Schema
| Campo | Tipo | Requerido | Descripción |
|---|---|---|---|
tipoContribuyente | enum | Sí | CONTRIBUYENTE o NO_CONTRIBUYENTE. Únicos dos valores. Siempre obligatorio, en toda operación |
tipoOperacion | enum | Sí | B2B, B2C, B2G, B2F |
tipoContribuyenteReceptor | enum | Condicional | PERSONA_FISICA o PERSONA_JURIDICA — obligatorio cuando tipoContribuyente = CONTRIBUYENTE; no se envía cuando es NO_CONTRIBUYENTE (SIFEN lo rechaza con el código 1303) |
tipoDocumento | enum | Condicional | CEDULA_PARAGUAYA, PASAPORTE, CEDULA_EXTRANJERA, CARNET_DE_RESIDENCIA, INNOMINADO, TARJETA_DIPLOMATICA, OTRO — requerido cuando tipoContribuyente = NO_CONTRIBUYENTE; no se envía cuando es CONTRIBUYENTE |
numeroDocumento | string | Sí | RUC base (sin DV), número de CI, pasaporte, etc. Para el caso innominado se envía el literal "0" |
nombreRazonSocial | string | Sí | Nombre completo o razón social. Para el caso innominado se envía el literal "Sin Nombre" |
digitoVerificador | string | Condicional | DV del RUC, un solo dígito — obligatorio cuando tipoContribuyente = CONTRIBUYENTE |
direccion | string | Condicional | Opcional para B2B / B2C / B2G. Obligatoria solo para Nota de Remisión Electrónica (NRE) y operaciones B2F (cliente del exterior con tipoOperacion = B2F). |
numeroCasa | integer | Condicional | Número de casa; obligatorio para B2F |
departamento | string | No | Departamento (Central, Alto Paraná, etc.) |
codigoDistrito | integer | No | Código del distrito (catálogo geográfico SIFEN) |
ciudad | string | No | Ciudad |
telefono | string | No | Teléfono fijo |
celular | string | No | Teléfono móvil |
email | string | No | Email — Sifende lo usa para enviar el KuDE automáticamente si está configurado |
codigoCliente | string | No | Código libre del emisor para identificar al cliente, de 3 a 15 caracteres. SIFEN no aplica validaciones de negocio y no lo muestra en el KuDE |
pais | enum | No | Por defecto PRY. Usar el código ISO para extranjeros |
Las reglas condicionales de esta tabla están expresadas como if/then en el spec OpenAPI, así que se pueden validar localmente antes de mandar la solicitud.
Reglas clave
- B2B: No envíes
tipoDocumento. El receptor se identifica portipoOperacion: "B2B"+tipoContribuyente: "CONTRIBUYENTE"+tipoContribuyenteReceptor+numeroDocumento(RUC) +digitoVerificador. Los tres últimos son obligatorios: sintipoContribuyenteReceptoro sindigitoVerificadorla API responde400 validation-error. Ladirecciones opcional. - B2C:
tipoContribuyente = NO_CONTRIBUYENTEy generalmentetipoDocumento = CEDULA_PARAGUAYA. Para el receptor innominado (sin identificación) se usatipoDocumento = INNOMINADOconnumeroDocumento: "0"ynombreRazonSocial: "Sin Nombre"— ambos siguen siendo obligatorios. Sólo se permite en Factura Electrónica, no en Nota de Crédito ni de Débito. Ladirecciones opcional. - B2G (gobierno):
tipoOperacion = B2G,tipoContribuyente = CONTRIBUYENTEypais = PRY. ExigenumeroDocumentocon el RUC de 3 a 8 dígitos,digitoVerificadorde un dígito ytipoContribuyenteReceptor. No envíestipoDocumento. Ladirecciones opcional. Ver Compras públicas. - B2F (exterior): Usar
tipoContribuyente = NO_CONTRIBUYENTE,tipoDocumento = PASAPORTE(oCEDULA_EXTRANJERA,CARNET_DE_RESIDENCIA,TARJETA_DIPLOMATICA,OTRO) ypaiscon el código ISO correspondiente. El país debe ser distinto dePRY;direccionynumeroCasason obligatorios. Omitídepartamento,ciudad,codigoDistrito,digitoVerificadorytipoContribuyenteReceptor. En una FE, B2F sólo admitetipoTransaccion = PRESTACION_SERVICIOS;VENTA_MERCADERIArecibe400 validation-error. - Nota de Remisión Electrónica (NRE): la
direcciondel receptor es obligatoria porque la NRE documenta un traslado físico de mercadería.