Tabla de contenidos
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 |
| 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 #
# 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
