# Receptor (/docs/referencia/modelos/receptor)



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 [#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`. Un receptor `NO_CONTRIBUYENTE` sólo admite `B2C` o `B2F`                                                                                                                                                            |
| `tipoContribuyenteReceptor` | `enum`    | Condicional      | `PERSONA_FISICA` o `PERSONA_JURIDICA` — &#x2A;*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í, salvo en B2F | RUC base (sin DV), número de CI, pasaporte, etc. El RUC lleva de 3 a 8 caracteres, sin guion ni cero inicial (por ejemplo `80012345`). Para el caso innominado se envía el literal `"0"`. En B2F es opcional; si se envía, no puede estar vacío |
| `nombreRazonSocial`         | `string`  | Sí               | Nombre completo o razón social, de 4 a 255 caracteres. Para el caso innominado se envía el literal `"Sin Nombre"`                                                                                                                               |
| `digitoVerificador`         | `string`  | Condicional      | DV del RUC, un solo dígito — &#x2A;*obligatorio cuando `tipoContribuyente = CONTRIBUYENTE`**. Debe corresponder al RUC informado (módulo 11)                                                                                                    |
| `descripcionTipoDocumento`  | `string`  | Con `OTRO`       | De 9 a 41 caracteres; obligatoria y exclusiva de `tipoDocumento = OTRO`                                                                                                                                                                         |
| `nombreFantasia`            | `string`  | No               | Nombre de fantasía, de 4 a 255 caracteres; se informa además de `nombreRazonSocial`                                                                                                                                                             |
| `direccion`                 | `string`  | Condicional      | Hasta 255 caracteres. 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, `0` si no tiene; obligatorio para B2F y en una FE que informa `direccion`                                                                                                                                                       |
| `departamento`              | `string`  | Condicional      | Departamento del catálogo de [geografía](/docs/referencia/catalogos/geografia); en una FE se informa junto con `ciudad`, y los dos son obligatorios si se informa `direccion` fuera de B2F                                                      |
| `codigoDistrito`            | `integer` | No               | Código del distrito (catálogo geográfico SIFEN)                                                                                                                                                                                                 |
| `ciudad`                    | `string`  | Condicional      | Ciudad; en una FE se informa junto con `departamento`, y la combinación debe existir en el catálogo                                                                                                                                             |
| `telefono`                  | `string`  | No               | Teléfono fijo, de 6 a 15 caracteres                                                                                                                                                                                                             |
| `celular`                   | `string`  | No               | Teléfono móvil, de 10 a 20 caracteres                                                                                                                                                                                                           |
| `email`                     | `string`  | No               | Email, de 3 a 80 caracteres — va siempre en el XML; Sifende además envía el KuDE a esta dirección según la opción de [envío por correo](/docs/guias/descargar-kude#cuándo-envía-sifende-el-correo-al-receptor)                                  |
| `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`. B2B, B2C y B2G exigen `PRY`; B2F exige el código ISO de un país distinto de `PRY`                                                                                                                                            |

Las reglas condicionales de esta tabla están expresadas como `if`/`then` en el [spec OpenAPI](/docs/referencia/openapi), así que se pueden validar localmente antes de mandar la solicitud.

## Reglas clave [#reglas-clave]

* **B2B:** No envíes `tipoDocumento`. El receptor se identifica por `tipoOperacion: "B2B"` + `tipoContribuyente: "CONTRIBUYENTE"` + `tipoContribuyenteReceptor` + `numeroDocumento` (RUC) + `digitoVerificador`. Los tres últimos son obligatorios: sin `tipoContribuyenteReceptor` o sin `digitoVerificador` la API responde `400 validation-error`. La `direccion` es opcional.
* **B2C:** `tipoContribuyente = NO_CONTRIBUYENTE` y generalmente `tipoDocumento = CEDULA_PARAGUAYA`. Para el receptor innominado (sin identificación) se usa `tipoDocumento = INNOMINADO` con `numeroDocumento: "0"` y `nombreRazonSocial: "Sin Nombre"` — ambos siguen siendo obligatorios. Sólo se permite en Factura Electrónica, no en Nota de Crédito ni de Débito. La `direccion` es opcional.
* **B2G (gobierno):** `tipoOperacion = B2G`, `tipoContribuyente = CONTRIBUYENTE` y `pais = PRY`. Exige `numeroDocumento` con el RUC de 3 a 8 caracteres sin cero inicial, con una letra final A-D opcional, `digitoVerificador` de un dígito y `tipoContribuyenteReceptor`. No envíes `tipoDocumento`. La `direccion` es opcional. Ver [Compras públicas](/docs/referencia/modelos/factura-electronica#compras-públicas).
* **B2F (exterior):** Usar `tipoContribuyente = NO_CONTRIBUYENTE`, `tipoDocumento = PASAPORTE` (o `CEDULA_EXTRANJERA`, `CARNET_DE_RESIDENCIA`, `TARJETA_DIPLOMATICA`, `OTRO`) y `pais` con el código ISO correspondiente. El país debe ser distinto de `PRY`; `direccion` y `numeroCasa` son obligatorios. `numeroDocumento` es opcional: si el cliente no tiene un número para informar, omití el campo. Omití `departamento`, `ciudad`, `codigoDistrito`, `digitoVerificador` y `tipoContribuyenteReceptor`. En una FE, B2F sólo admite `tipoTransaccion = PRESTACION_SERVICIOS`; `VENTA_MERCADERIA` recibe `400 validation-error`.
* **Nota de Remisión Electrónica (NRE):** la `direccion` del receptor es obligatoria porque la NRE documenta un traslado físico de mercadería.

## Departamento y ciudad [#departamento-y-ciudad]

`departamento`, `codigoDistrito` y `ciudad` se resuelven contra el catálogo de [geografía](/docs/referencia/catalogos/geografia):

* `departamento` acepta el `name` de la categoría `departamento` de [`/public/enums`](/docs/referencia/catalogos/enumeraciones) (`PTE_HAYES`), el nombre del catálogo (`PTE. HAYES`) o el código como texto (`"15"`).
* `ciudad` acepta el `nombre` o el `codigo` (como texto) de una ciudad del catálogo. Si el nombre del catálogo termina en un calificador entre paréntesis, podés omitirlo: `"Asunción"` resuelve `ASUNCION (DISTRITO)`.
* En los nombres no importan mayúsculas, tildes, puntos ni guiones bajos.
* Si el nombre coincide con más de una ciudad del departamento, la API responde `400 validation-error`. En `errores["receptor.ciudad"]` lista las opciones con su `codigoDistrito` y su código. Enviá `codigoDistrito` o el código de la ciudad.
* SIFEN admite hasta 30 caracteres en la descripción de la ciudad. Si el nombre del catálogo es más largo, el documento lo lleva recortado.

## Ejemplos [#ejemplos]

<Tabs>
  <Tab value="b2c" label="B2C — Consumidor final">
    ```json
    {
      "receptor": {
        "tipoContribuyente": "NO_CONTRIBUYENTE",
        "tipoOperacion": "B2C",
        "tipoDocumento": "CEDULA_PARAGUAYA",
        "numeroDocumento": "1234567",
        "nombreRazonSocial": "Juan Pérez",
        "email": "juan.perez@example.com.py"
      }
    }
    ```
  </Tab>

  <Tab value="b2c-innominado" label="B2C — Innominado">
    ```json
    {
      "receptor": {
        "tipoContribuyente": "NO_CONTRIBUYENTE",
        "tipoOperacion": "B2C",
        "tipoDocumento": "INNOMINADO",
        "numeroDocumento": "0",
        "nombreRazonSocial": "Sin Nombre"
      }
    }
    ```

    Los literales `"0"` y `"Sin Nombre"` los define el Manual Técnico de SIFEN para el caso innominado: no son valores de relleno, tienen que ir exactamente así.
  </Tab>

  <Tab value="b2b" label="B2B — Empresa con RUC">
    ```json
    {
      "receptor": {
        "tipoContribuyente": "CONTRIBUYENTE",
        "tipoOperacion": "B2B",
        "tipoContribuyenteReceptor": "PERSONA_JURIDICA",
        "numeroDocumento": "80054321",
        "digitoVerificador": "1",
        "nombreRazonSocial": "Distribuidora Asunción S.R.L.",
        "codigoCliente": "CLI-001",
        "direccion": "Av. Mariscal López",
        "numeroCasa": 1234,
        "departamento": "CAPITAL",
        "ciudad": "Asunción",
        "email": "facturacion@distribuidora-asuncion.com.py"
      }
    }
    ```
  </Tab>

  <Tab value="b2f" label="B2F — Cliente del exterior">
    ```json
    {
      "receptor": {
        "tipoContribuyente": "NO_CONTRIBUYENTE",
        "tipoOperacion": "B2F",
        "tipoDocumento": "PASAPORTE",
        "numeroDocumento": "AB1234567",
        "nombreRazonSocial": "John Smith",
        "direccion": "1234 Main Street, Miami, FL 33101",
        "numeroCasa": 1234,
        "pais": "USA"
      }
    }
    ```
  </Tab>
</Tabs>

## Próximos pasos [#próximos-pasos]

* [Guía: Receptor B2B vs B2C](/docs/guias/receptor-b2b-b2c)
* [Concepto: Receptor](/docs/conceptos/receptor)
