Facturas: Reconocimiento de texto (OCR)

/OCR (Recibos y facturas)

Esta API se utiliza para leer información de una imagen de documento con tecnología OCR de Facephi y organizar la información en campos.

Uso

Campo	Descripción
type	Es necesario especificar el tipo de documento que desea procesar, ya que nuestro servicio puede manejar diferentes tipos. Valores disponibles en el JSON: id_card, foreign_card, invoice, pdf.
model	Este parámetro especifica el ID del documento a procesar. En el caso de facturas o documentos PDF, consulte la lista a continuación. De lo contrario, este identificador corresponde al país de origen del documento. Para especificar este país, siga el estándar especificado en ISO_3166-1 alpha-3. En caso de factura o pdf, utilice la clave en las tablas siguientes.
files	Array de cadenas. Cada posición del array es un búfer de imagen sin procesar codificado en base64 RFC4648. Máximo dos archivos. La primera imagen será el anverso de un id_card (documento de identidad).

Modelos admitidos

Tipos de documento admitidos (parámetro type)

Tipo	Valor
Documento de Identidad (ID Card)	id_card
Documento Extranjero (Foreign Card)	foreign_card
PDF	pdf
Factura (Invoice)	invoice

Documentos de identidad admitidos (parámetro model)

Modelo	Valor
Argentina	ARG
México	MEX

Documentos extranjeros admitidos (parámetro model)

Modelo	Valor
México	MEX

Facturas admitidas (parámetro model)

Modelo	Valor
TELMEX	TELMEX
CFE	CFE

PDFs admitidos (parámetro model)

Modelo	Valor
IVA: El Salvador	IVA
RENTA: El Salvador	RENTA

Ejemplo de solicitud:

bash

curl --location '{IDENTITY_API_BASE_URL}/ocr' \
--header 'x-api-key: {IDENTITY_API_APIKEY}' \
--header 'Content-Type: application/json' \
--data '{
  "type": "pdf",
  "model": "IVA",
  "files": ["JVBERi0xLjQKJeLjz9MKNSAwIG9iago8P..."]
}'

Ejemplo de respuesta:

200 OK

json

{
    "serviceResultCode": 200,
    "serviceResultLog": "Servicio ejecutado correctamente",
    "timestamp": "2024-07-12T09:43:36Z",
    "serviceTransactionId": "99999999-9999-9999-9999-999999999999",
    "serviceResult": {
        "dictionary": {
            "CommercialName": "Nombre Comercial Ejemplo",
            "DeclarationNumber": "11111111111",
            "EconomicActivity": "Transportes Nacionales",
            "NIT": "9999-999999-999-9",
            "NRC": "999999-9",
            "Name": "John Doe",
            "TaxedPeriod": "04 2021"
        },
        "model": "IVA",
        "side": "anverso",
        "type": "pdf",
        "version": "2021"
    },
    "serviceTime": "638"
}