Consultar un Documento por ID

Esta invocación consulta un determinado registro por el ID del documento en FacturaSend.

Este servicio es similar al servicio “Consultar un Documento por CDC“, con la diferencia del parámetro de entrada.

Obtener el ID #

El Id del registro puede ser visualizado en la consola de FacturaSend, cada registro es único y tiene un único ID, no importando si es una Factura, una Nota de crédito u cualquier otro documento.

Endpoint (URL) #

GET https://api.facturasend.com.py/<tenantId>/de/id/<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/id/2731"  
  -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/id/2731`, 
  {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