---
title: Evento de nominación
description: Evento destinado para informar a SIFEN el receptor de una factura, cuando la factura originalmente fue hecha a un innominado. Es un evento que depende de la necesidad del emisor, a menudo cuando necesita realizar una nota de crédito sobre…
url: "https://facturasend.com.py/documentacion/evento-de-nominacion/"
updated: "2025-12-10"
category: "3-API de FacturaSend"
---

# Evento de nominación

Evento destinado para informar a SIFEN el receptor de una factura, cuando la factura originalmente fue hecha a un innominado.

Es un evento que depende de la necesidad del emisor, a menudo cuando necesita realizar una nota de crédito sobre una factura que originalmente se generó a un innominado.

Tenga en cuenta los parámetros para enviar el evento.

### Obtener el CDC

Es importante que se haya almacenado el CDC de cualquier documento electrónico generado en su sistema, para poder usarlo, por ejemplo en éste evento.

### Endpoint (URL)

**POST**https://api.facturasend.com.py/<tenantId>/evento/nominacion

### Header (Encabezado)

Requiere el envío del los siguientes atributos en el encabezado

| Campo | Valor |
| --- | --- |
| Authorization | Bearer api_key_**reemplazar_api_key** |
| Content-Type | `application/json; charset=utf-8` |

### Parámetros (BODY)

```
{
  "cdc": `01800695631001002100700812022063013102931279`,  // DTE
  "motivo": `Se asigna el receptor correcto del DTE`,
  "contribuyente" : true,
  "tipoReceptor" : 1,
  "ruc" : "2005001-1",
  "razonSocial" : "Marcos Adrian Jara Rodriguez",
  "nombreFantasia" : "Marcos Adrian Jara Rodriguez",
  "tipoOperacion" : 1,
  "direccion" : "Avda Calle Segunda y Proyectada",
  "numeroCasa" : "1515",
  "departamento" : 11,
  "departamentoDescripcion" : "ALTO PARANA",
  "distrito" : 143,
  "distritoDescripcion" : "DOMINGO MARTINEZ DE IRALA",
  "ciudad" : 3344,
  "ciudadDescripcion" : "PASO ITA (INDIGENA)",
  "pais" : "PRY",
  "paisDescripcion" : "Paraguay",
  "telefono" : "061874874",
  "celular" : "595976254125",
  "email" : "cliente@cliente.com",
  "codigo" : "1548"
}
```

| Campo | Requerido | Valor |
| --- | --- | --- |
| ****cdc**** | **Si** | El CDC del Documento Electrónico que desea nominar. Debe existir en Facturasend |
| ****motivo**** | **Si** | El motivo del evento de nominación |
| ****contribuyente**** | **Si** | Campo booleano que indica si el nominado es o no un contribuyente |
| tipoReceptor | No | Tipo de contribuyente Ej.: 1= Persona Física, 2= Persona Jurídica *Obligatorio si contribuyente = **true**, No informar si contribuyente = **false*** |
| ruc | No | RUC del Receptor con el digito verificador. *Obligatorio si el nominado es un contribuyente.* |
| **razonSocial** | **Si** | Nombre o Razón Social del Receptor |
| nombreFantasia | No | Nombre de Fantasía del Receptor |
| **tipoOperacion** | **Si** | Tipo de Operación del Receptor, siendo: 1-B2B, 2-B2C, 4-B2F |
| direccion | No | Dirección del Receptor. Obligatorio si tipoOperacion=4 |
| numeroCasa | No | Número de Casa del Receptor. Cuando es contribuyente debe corresponder a lo declarado en el RUC *Obligatorio si se pasa la dirección.* |
| departamento | No | Código del departamento *Obligatorio si se informa la dirección y tipoOperacion ≠ 4, no se debe informar cuando tipoOperacion = 4.* |
| distrito | No | Código del distrito del Cliente, El código debe seguir la Tabla 2.1 – Distritos del Manual Técnico. *Obligatorio si se informa la dirección y tipoOperacion ≠ 4, no se debe informar cuando tipoOperacion = 4.* |
| ciudad | No | Código de la ciudad del Cliente. *Obligatorio si se informa la dirección y tipoOperacion ≠ 4, no se debe informar cuando tipoOperacion = 4.* |
| **pais** | **Si** | Código del Pais del Cliente, Según XSD de Codificación de Países |
| documentoTipo | No | Tipo de documento del cliente, de acuerdo a: 1=Cédula paraguaya 2=Pasaporte 3=Cédula extranjera 4=Carnet de residencia 5=Tarjeta Diplomática de exoneración fiscal 9=Otro (informar data.documentoTipoDescripcion). *Obligatorio si data.contribuyente = false* |
| documentoNumero | No | Número de documento de identidad. *Obligatorio si data.contribuyente = false* |
| telefono | No | Número de teléfono. Debe incluir el prefijo de la ciudad si pais = PRY |
| celular | No | Numero de celular del cliente |
| email | No | Correo electrónico del cliente Si se le pasa más de un correo (separado por comas) en eKuatia se incluirá sólo el primero |
| **codigo** | **Si** | Código del Cliente, obligatorio para FacturaSend |

### Parámetros (Query Param)

No posee

### Ejemplo de llamadas

- [shell](#tab-shell)
- [javascript](#tab-javascript)

```
# Invoca el evento de nominación
curl 
  -X 
  POST "https://api.facturasend.com.py/<tenantId>/evento/nominacion" 
  -H "Authorization: Bearer api_key_<reemplazar_api_key>" 
  -H 'Content-Type: application/json; charset=utf-8' 
  --data-raw '{
        "cdc": `01800695631001002100700812022063013102931279`,  // DTE
        "motivo": `Se asignar el receptor correcto del DTE`,
        "contribuyente" : true,
        "tipoReceptor" : 1,
        "ruc" : "2005001-1",
        "razonSocial" : "Marcos Adrian Jara Rodriguez",
        "nombreFantasia" : "Marcos Adrian Jara Rodriguez",
        "tipoOperacion" : 1,
        "direccion" : "Avda Calle Segunda y Proyectada",
        "numeroCasa" : "1515",
        "departamento" : 11,
        "departamentoDescripcion" : "ALTO PARANA",
        "distrito" : 143,
        "distritoDescripcion" : "DOMINGO MARTINEZ DE IRALA",
        "ciudad" : 3344,
        "ciudadDescripcion" : "PASO ITA (INDIGENA)",
        "pais" : "PRY",
        "paisDescripcion" : "Paraguay",
        "telefono" : "061874874",
        "celular" : "595976254125",
        "email" : "cliente@cliente.com",
        "codigo" : "1548"
  }'
```

```
# El ejemplo se muestra utilizando AXIOS
import axios from 'axios';

const headers = {
  `Authorization` : `Bearer api_key_<reemplazar_api_key>`
};

const data = {
  "cdc": `01800695631001002100700812022063013102931279`,  // DTE
  "motivo": `Se asigna el receptor correcto del DTE`,
  "contribuyente" : true,
  "tipoReceptor" : 1,
  "ruc" : "2005001-1",
  "razonSocial" : "Marcos Adrian Jara Rodriguez",
  "nombreFantasia" : "Marcos Adrian Jara Rodriguez",
  "tipoOperacion" : 1,
  "direccion" : "Avda Calle Segunda y Proyectada",
  "numeroCasa" : "1515",
  "departamento" : 11,
  "departamentoDescripcion" : "ALTO PARANA",
  "distrito" : 143,
  "distritoDescripcion" : "DOMINGO MARTINEZ DE IRALA",
  "ciudad" : 3344,
  "ciudadDescripcion" : "PASO ITA (INDIGENA)",
  "pais" : "PRY",
  "paisDescripcion" : "Paraguay",
  "telefono" : "061874874",
  "celular" : "595976254125",
  "email" : "cliente@cliente.com",
  "codigo" : "1548"
};

axios.post({
  url: `https://api.facturasend.com.py/<tenantId>/evento/nominacion`,
  method: 'POST',
  {headers}
}
).then( respuesta => {
  console.log(respuesta);
});
```

### Respuesta de la Petición

La respuesta de la petición será la siguiente:

```
{
  "success" : true,
  "result" : {
    "ns2:rRetEnviEventoDe" : {
      "ns2:gResProcEVe" : "2022-02-08T14:39:00",
      "ns2:gResProcEVe" : {
        "ns2:dEstRes" : "Aprobado",
        "ns2:gResProc" : {
           "ns2:dCodRes" : "",
           "ns2:dMsgRes" : ""
        }
      }
    }
  }
}
```

| Campo | Tipo | Valor |
| --- | --- | --- |
| success | boolean | **true** si todo ocurrió bien y se inutilizaron las numeraciones del timbrado, **false** si ocurrió algún error |
| result | object | Objeto resultante de la operación del evento, directamente en el formato que devuelve el SIFEN |

### Recomendaciones

- No aplica

### Validaciones

- No aplica