Buscar Factura

GET /invoicing/find

Busca y obtiene los datos de una factura electrónica por su ID o por su CUFE.

Autenticación

Requiere header X-SOLERBA-TOKEN. Ver .

Query Parameters

Parámetro	Tipo	Requerido	Descripción
id	integer	Condicional	ID de la factura en Solerba
cufe	string	Condicional	Código Único de Factura Electrónica

Al menos uno requerido

Debes enviar al menos uno de los dos parámetros (id o cufe). Si envías ambos, se usa el id como criterio principal.

Ejemplo por ID

curl -X GET "https://api.solerba.com/external-api/invoicing/find?id=18874" \
  -H "X-SOLERBA-TOKEN: tu-api-token-aqui"

Ejemplo JS

const response = await fetch('https://api.solerba.com/external-api/invoicing/find?id=18874', {
  headers: {
    'X-SOLERBA-TOKEN': process.env.SOLERBA_TOKEN
  }
});

const result = await response.json();
console.log(result);

Ejemplo Py

import requests

response = requests.get(
    'https://api.solerba.com/external-api/invoicing/find',
    params={'id': 18874},
    headers={'X-SOLERBA-TOKEN': 'tu-api-token-aqui'}
)

result = response.json()
print(result)

Ejemplo por CUFE

curl -X GET "https://api.solerba.com/external-api/invoicing/find?cufe=FE0120000155704849-2-2021-3200012026021019600000460010129600000462" \
  -H "X-SOLERBA-TOKEN: tu-api-token-aqui"

Ejemplo JS

const cufe = 'FE0120000155704849-2-2021-3200012026021019600000460010129600000462';
const response = await fetch(`https://api.solerba.com/external-api/invoicing/find?cufe=${cufe}`, {
  headers: {
    'X-SOLERBA-TOKEN': process.env.SOLERBA_TOKEN
  }
});

const result = await response.json();
console.log(result);

Ejemplo Py

import requests

response = requests.get(
    'https://api.solerba.com/external-api/invoicing/find',
    params={'cufe': 'FE0120000155704849-2-2021-3200012026021019600000460010129600000462'},
    headers={'X-SOLERBA-TOKEN': 'tu-api-token-aqui'}
)

result = response.json()
print(result)

Respuesta exitosa

HTTP 200 OK

{
  "success": true,
  "result": {
    "id": 18874,
    "doctype": "01",
    "cufe": "FE0120000155704849-2-2021-3200012026021019600000460010129600000462",
    "datetime": "2026-03-20T15:30:00.000Z",
    "documentTotal": 107,
    "totalBTaxes": 100,
    "totalWTaxes": 107,
    "qtyItems": 1,
    "urlPdf": "https://storage.solerba.com/invoices/18874.pdf",
    "canceled": false,
    "success": true
  }
}

Campo	Tipo	Descripción
id	integer	ID de la factura en Solerba
doctype	string	Tipo de documento ("01" o "04")
cufe	string	Código Único de Factura Electrónica
datetime	string	Fecha y hora de emisión
documentTotal	number	Total del documento con impuestos
totalBTaxes	number	Total antes de impuestos (subtotal)
totalWTaxes	number	Total con impuestos
qtyItems	integer	Cantidad de ítems en la factura
urlPdf	string	URL de descarga del PDF
canceled	boolean	Si la factura fue cancelada
success	boolean	Si la factura fue emitida exitosamente

Problemas comunes

Error	Causa	Solución
401 Unauthorized	Token inválido o expirado	Verifica tu API Token
400 — parámetro requerido	No se envió id ni cufe	Incluye al menos uno de los dos parámetros
404 Not Found	No se encontró la factura	Verifica que el id o cufe sea correcto y pertenezca a la empresa del token

Siguientes pasos

• — Emite una nueva factura
• — Cancela una factura existente
• — Valida datos fiscales de un contribuyente