Búsqueda de facturas por externalId

21/09/2026

Esta actualización permite buscar una factura por el externalId que enviaste al crearla, además de por id o cufe. El cambio es retrocompatible: las integraciones que consultan por id o cufe siguen funcionando sin modificaciones.

Nueva función

Buscar factura por externalId Nuevo

Hasta ahora, para consultar una factura con GET /invoicing/find era necesario guardar el id o el cufe que devolvía Solerba al emitirla. Si tu POS o ERP ya envía su propio número de orden o referencia en externalId (el mismo campo que se usa para la ), ahora puedes recuperar la factura directamente con ese valor:

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

Parámetro	Tipo	Descripción
externalId	string	Identificador de tu sistema enviado al crear la factura (1 a 100 caracteres)

Reglas:

• Debes enviar al menos uno de id, cufe o externalId. Si envías varios, la prioridad es id → cufe → externalId.
• La comparación es exacta: se respetan ceros iniciales y mayúsculas/minúsculas (000123 ≠ 123).
• La búsqueda está limitada a la empresa del token; no es posible consultar facturas de otras empresas.
• Si existe más de una factura con el mismo externalId, se devuelve la más reciente.
• La consulta está optimizada y responde con la misma rapidez que por id.

externalId en la respuesta

La respuesta de GET /invoicing/find ahora incluye el campo externalId cuando la factura fue creada con uno, para que puedas correlacionarla con tu sistema sin consultas adicionales.

{
  "success": true,
  "result": {
    "id": 18874,
    "externalId": "ORDER_12345",
    "doctype": "01",
    "cufe": "FE0120000155704849-2-2021-3200012026021019600000460010129600000462"
  }
}

Documentación

• documenta el parámetro externalId, un ejemplo completo en cURL, JavaScript y Python, la regla de coincidencia exacta y los errores 400 asociados
• incluye la consulta por externalId en el paso 5
• enlaza la búsqueda por externalId como continuación natural del flujo