View Categories

SIFEN – Consulta DTE por CDC

2 minutos de lectura

Este servicio consulta la existencia de un documento electrónico directamente en el SIFEN, a travéz de la API del eKuatia.

Esta consulta también puede realizarse desde el panel de FacturaSend, todas las consultas anteriores realizadas quedan almacenadas y se despliegan en un listado.

Para invocar éste servicio se requiere que la empresa relacionada al tenantId esté conectada a SIFEN, y también se requiere de un Certificado Digital válido.

Endpoint (URL) #

POST https://api.facturasend.com.py/<tenantId>/dte/cdc/<cdc>

Header (Encabezado) #

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

CampoValor
AuthorizationBearer api_key_reemplazar_api_key

Parámetros (BODY) #

No posee

Parámetros (Query Param) #

No posee

Ejemplo de llamadas #

# Consulta de un DTE por el Código de Control (CDC)
curl \
  -X \
  POST "https://api.facturasend.com.py/<tenantId>/dte/cdc/01800695631001001000000612021112917595714694"  
  -H "Authorization: Bearer api_key_<reemplazar_api_key>"
# El ejemplo se muestra utilizando AXIOS
import axios from 'axios';

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

axios.post(`https://api.facturasend.com.py/<tenantId>/dte/cdc/01800695631001001000000612021112917595714694`, 
  {headers}
)
.then( respuesta => {
  console.log(respuesta);
});

Respuesta de la Petición #

{
  "success": true,
  "fecha": "2022-01-22T12:07:48-03:00",
  "respuesta_codigo": "0422",
  "respuesta_mensaje": "CDC encontrado",
  "xml": "<xml? >...<rDE>",
  "protocolo": "93891821"
}
CampoTipoDescripción
successbooleantrue si la consulta se ejecutó con éxito, false si dio algún error
errorstringEl mensaje de error en caso de que haya retornado success=false.
fechadate-timeFecha y hora de la consulta, ésta información es del servidor de eKuatia
respuesta_codigostringCódigo de respuesta de la consulta.
Valores:
0422=CDC encontrado.
0420=CDC inexistente.
0421=RUC Certificado sin permiso
respuesta_mensajestringMensaje de respuesta de la consulta.
Valores:
0422=CDC encontrado.
0420=CDC inexistente.
0421=RUC Certificado sin permiso
xmlstringSi la respuesta_codigo = 0422, entonces aquí retornará el XML obtenido desde el eKuatia.
protocolostringSi la respuesta_codigo = 0422, entonces aquí retornará el Protocolo de Autorización obtenido desde el eKuatia.

Recomendaciones #

  • No aplica

Validaciones #

  • No aplica