Consultar un Documento por CDC

Este servicio consulta los datos del DE de FacturaSend por medio del CDC, recuperando informaciones importantes para el control de flujo.

Este servicio es similar al servicio “Consulta DE por ID“, con la diferencia del parámetro de entrada.

Obtener el CDC #

El CDC se devuelve al crear un documento electrónico, el cual debe ser almacenado por el integrador en su sistema, relacionándolo con el movimiento correspondiente. El CDC también puede ser obtenido desde la consulta de un determinado documento electrónico por medio de la consola.

Para obtener el CDC de cualquier documento desde la consola de FacturaSend debe ingresar al documento electrónico, seleccionando con un clic:

Luego en la pestaña de VER, debe desplazarse hasta el final de la página. El CDC aparecerá antes de los botones de acción, cómo se visualiza a continuación:

Endpoint (URL) #

GET https://api.facturasend.com.py/<tenantId>/de/cdc/<id>

Header (Encabezado) #

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

Parámetros (BODY) #

No posee

Parámetros (Query Param) #

No posee

curl \
  -X \
  GET "https://api.facturasend.com.py/<tenantId>/de/cdc/01800695631001002100732012024072311932227581"  
  -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.get(`https://api.facturasend.com.py/<tenantId>/de/cdc/01800695631001002100732012024072311932227581`, 
  {headers}
)
.then( respuesta => {
  console.log(respuesta);
});

Respuesta de la Petición #

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

{
  "success": true,
  "result": {
    "id": 2731,
    "fecha": "2025-03-11T18:49:26.840Z",
    "rde": {
      //Contenido del XML en formato JSON
    },
    "situacion": 4,
    "is_conectado": 1,
    "is_borrado": 0,
    "lote_id": 4254,
    "lote_estado": 3,
    "info_codigo": "1001",
    "info_descripcion": "CDC duplicado"
  }
}

Recomendaciones #

• No aplica

Codificaciones de la Salida #

Situaciones de un DE – (result.situacion)

Los siguientes números son codificaciones para la situación de cualquier documento Electrónico. Se recomienda que utilice ésta misma codificación en su sistema.

-1 = Borrador
0 = Generado DE
1 = Enviado en un Lote
2 = Aprobado
3 = Aprobado con observación
4 = Rechazado
98 = Inexistente
99 = Cancelado.

Ambiente de Conexión a SIFEN (result.is_conectado)

0 = No conectado a SIFEN
1 = Conectado a Ambiente de Pruebas
2 = Conectado a Producción SIFEN

Borrado Lógico del Registro (result.is_borrado)

Los documentos enviados a FacturaSend, nunca se eliminan, ni si son rechazados. Para evitar duplicaciones en la consola y evitar confusiones de documentos, aquellos documentos que no serán más utilizados, se marcan internamente con una opción de borrado, pero siempre permanecen en la base para que puedan ser recuperados. De esta forma se mantiene el histórico.

0 = Documento vigente (válido)
1 = Documento borrado lógicamente

Estado del Lote (result.lote_estado)

La situación de los documentos difiere del estado de los lotes, ya que cada uno de ellos mantiene su propia información independiente.

0 = Lote Generado (en FacturaSend, no así en SIFEN)
1 = Lote no encolado (no enviado a SIFEN), puede ser por algún error.
2 = Lote encolado (enviado a SIFEN), y esperando su procesamiento
3 = Lote con proceso concluido (los documentos pudieron aprobarse o rechazarse en SIFEN)
4 = Lote en borrador (cuando se envía con la opción borrador)
5 = Lote en borrador rechazado (los lotes rechazados no borran de FacturaSend)

Validaciones #

• No aplica