Receptor

Schema del objeto receptor — datos del destinatario del documento para operaciones B2B y B2C.

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`, `NO_CONTRIBUYENTE`, `EXTRANJERO`, `NOMINADO`, `INNOMINADO`
`tipoOperacion`	`enum`	Sí	`B2B`, `B2C`, `B2G`, `B2F`
`tipoDocumento`	`enum`	Condicional	`CEDULA_PARAGUAYA`, `PASAPORTE`, `CEDULA_EXTRANJERA`, `CARNET_DE_RESIDENCIA`, `INNOMINADO`, `TARJETA_DIPLOMATICA`, `OTRO` — no aplica para B2B
`numeroDocumento`	`string`	Sí	RUC base (sin DV), número de CI, pasaporte, etc.
`nombreRazonSocial`	`string`	Sí	Nombre completo o razón social
`digitoVerificador`	`string`	Condicional	Solo cuando `tipoOperacion = B2B` o `B2G` (es el DV del RUC)
`direccion`	`string`	Condicional	Opcional para B2B / B2C / B2G. Obligatoria solo para Nota de Remisión Electrónica (`tipoDocumento = NOTA_REMISION_ELECTRONICA`) y operaciones B2F (cliente del exterior con `tipoOperacion = B2F`).
`numeroCasa`	`integer`	No	Número de casa
`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
`pais`	`enum`	No	Por defecto `PRY`. Usar el código ISO para extranjeros

Reglas clave

B2B: No envíes tipoDocumento. El receptor se identifica por tipoOperacion: "B2B" + tipoContribuyente: "CONTRIBUYENTE" + numeroDocumento (RUC) + digitoVerificador. La direccion es opcional.
B2C: Generalmente tipoDocumento = CEDULA_PARAGUAYA. El receptor INNOMINADO (sin identificación) sólo se permite en Factura Electrónica, no en Nota de Crédito. La direccion es opcional.
B2G (gobierno): Igual que B2B con tipoOperacion = B2G. La direccion es opcional.
B2F (exterior): Usar tipoContribuyente = EXTRANJERO, tipoDocumento = PASAPORTE (u otro) y pais con el código ISO correspondiente. La direccion es obligatoria porque SIFEN exige el domicilio del cliente extranjero (D210).
Nota de Remisión Electrónica (NRE): la direccion del receptor es obligatoria porque la NRE documenta un traslado físico de mercadería.

Ejemplos

{
  "receptor": {
    "tipoContribuyente": "NO_CONTRIBUYENTE",
    "tipoOperacion": "B2C",
    "tipoDocumento": "CEDULA_PARAGUAYA",
    "numeroDocumento": "1234567",
    "nombreRazonSocial": "Juan Pérez",
    "email": "juan.perez@example.com.py"
  }
}

{
  "receptor": {
    "tipoContribuyente": "CONTRIBUYENTE",
    "tipoOperacion": "B2B",
    "numeroDocumento": "80054321",
    "digitoVerificador": "7",
    "nombreRazonSocial": "Distribuidora Asunción S.R.L.",
    "direccion": "Av. Mariscal López 1234",
    "ciudad": "Asunción",
    "departamento": "Capital",
    "email": "facturacion@distribuidora-asuncion.com.py"
  }
}

{
  "receptor": {
    "tipoContribuyente": "EXTRANJERO",
    "tipoOperacion": "B2F",
    "tipoDocumento": "PASAPORTE",
    "numeroDocumento": "AB1234567",
    "nombreRazonSocial": "John Smith",
    "direccion": "1234 Main Street, Miami, FL 33101",
    "pais": "USA"
  }
}

Schema

Reglas clave

Ejemplos

Próximos pasos

On this page