View Categories

Evento de notificación

2 minutos de lectura

Evento destinado para informar a SIFEN que conoce dicho documento, sin embargo, aún no tiene condiciones para manifestarse de forma conclusiva (con Conformidad, Disconformidad o Desconocimiento).

Es un evento opcional.

Este servicio informa a SIFEN que usted desconoce un determinado documento electrónico y que ha sido generado erróneamente a su nombre o a su empresa.

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/notificacion

Header (Encabezado) #

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

CampoValor
AuthorizationBearer api_key_reemplazar_api_key
Content-Typeapplication/json; charset=utf-8

Parámetros (BODY) #

{
  "cdc": "01800695631001003000013712022010619364760029",    //DE o DTE
  "fechaEmision" : "2020-01-31T00:01:01",    //Fecha pasada
  "fechaRecepcion" : "2020-01-31T00:01:01",    //Fecha despues
  "tipoReceptor" : 1,
  "nombre" : "BRASIL CRESCENCIO",
  "ruc" : "50062360-0",
  "documentoTipo" : 11,
  "documentoNumero" : "",
  "totalPYG": "150000"
}
CampoRequeridoValor
cdcSiEl CDC del Documento Electrónico que desea informar
fechaEmisionSiFecha de emisión del Documento Electrónico
fechaRecepcionSiFecha de recepción del Documento Electrónico
tipoReceptorSiTipo de Receptor
nombreSiNombre del Receptor
rucSiRUC del Receptor con el digito verificador
documentoTipoSiTipo de Documento
documentoNumeroSiNumero de documento
totalPYGSiMonto total del documento en GS

Parámetros (Query Param) #

No posee

Ejemplo de llamadas #

# Informa a SIFEN de una notificación de un DTE
curl \
  -X \
  POST "https://api.facturasend.com.py/<tenantId>/evento/notificacion" \
  -H "Authorization: Bearer api_key_<reemplazar_api_key>" \
  -H 'Content-Type: application/json; charset=utf-8' \
  --data-raw '{
      "cdc": "01800695631001003000013712022010619364760029",    //DE o DTE
      "fechaEmision" : "2020-01-31T00:01:01",    //Fecha pasada
      "fechaRecepcion" : "2020-01-31T00:01:01",    //Fecha despues
      "tipoReceptor" : 1,
      "nombre" : "BRASIL CRESCENCIO",
      "ruc" : "50062360-0",
      "documentoTipo" : 11,
      "documentoNumero" : "",
      "motivo": "teste"
  }'
# El ejemplo se muestra utilizando AXIOS
import axios from 'axios';

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

const data = {
  "cdc": "01800695631001003000013712022010619364760029",    //DE o DTE
  "fechaEmision" : "2020-01-31T00:01:01",    //Fecha pasada
  "fechaRecepcion" : "2020-01-31T00:01:01",    //Fecha despues
  "tipoReceptor" : 1,
  "nombre" : "BRASIL CRESCENCIO",
  "ruc" : "50062360-0",
  "documentoTipo" : 11,
  "documentoNumero" : "",
  "totalPYG": "150000"
};

axios.post({
  url: `https://api.facturasend.com.py/<tenantId>/evento/notificacion`,
  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" : ""
        }
      }
    }
  }
}
CampoTipoValor
successbooleantrue si todo ocurrió bien y se inutilizaron las numeraciones del timbrado, false si ocurrió algún error
resultobjectObjeto resultante de la operación del evento, directamente en el formato que devuelve el SIFEN

Recomendaciones #

  • No aplica

Validaciones #

  • No aplica