Análisis de Facturas
Extraer datos estructurados de archivos de facturas
Automatice su flujo de trabajo de cuentas por pagar con nuestra API de Análisis de Facturas impulsada por IA. Cargue cualquier documento de factura y reciba datos completamente estructurados, desde detalles de proveedor y comprador hasta partidas, desgloses de impuestos y términos de pago, listos para su ERP, sistema contable o canal personalizado.
Formatos de factura admitidos - 8 tipos de archivos: DOC, DOCX, PDF, JPG, JPEG, PNG, TIFF, TIF
Sí - maneja facturas escaneadas, recibos fotografiados y PDFs aplanados donde el contenido de la factura está incrustado como imágenes en lugar de texto seleccionable.
Este punto final extrae una estructura de datos excepcionalmente detallada que cubre todos los aspectos de una factura: metadatos del documento, información del vendedor y comprador (incluyendo direcciones, ID de IVA y detalles bancarios), resúmenes financieros con desgloses de impuestos, partidas individuales, términos de pago, datos logísticos, referencias de facturas electrónicas y más.
Esta API es ideal para desarrolladores que crean plataformas contables, herramientas de gestión de gastos, sistemas de adquisiciones o integraciones ERP. Automatiza la extracción de datos de facturas que de otro modo requerirían ingreso de datos manual, asegurando precisión y reduciendo drásticamente el tiempo de procesamiento. Los casos de uso incluyen procesamiento automatizado de cuentas por pagar, validación de datos de facturas, análisis de gastos, gestión de proveedores y flujos de trabajo de conciliación financiera.
El archivo debe cargarse como parámetro form-data llamado file.
Un parámetro de idioma opcional también puede proporcionarse (el valor English está establecido como predeterminado).
Los trabajos de IA implican dos pasos clave:
- Enviando el trabajo de IA: Iniciando el proceso enviando la solicitud de trabajo.
- Monitoreo y recepción de resultados: Comprobando continuamente el estado del trabajo y obteniendo el resultado final una vez completado con éxito.
SDKs/Bibliotecas relacionadas
SharpAPI es ahora Cumple con SOC 2 Tipo II. Puede consultar los detalles en nuestro Portal del Centro de Confianza.
Tus datos son tus datos. Aprende cómo los protegemos y cumplimos con los estándares de privacidad globales en nuestro Política de manejo de datos y cumplimiento .
Paso 1. Enviar la solicitud de trabajo de IA
Endpoint: POST - /api/v1/finance/parse_invoice
EJEMPLO DE SOLICITUD:
curl --location 'https://sharpapi.com/api/v1/finance/parse_invoice' \
--header 'Accept: application/json' \
-H "Authorization: Bearer YOUR_API_TOKEN" \
--form 'file=@"invoice.pdf"'
EJEMPLO DE RESPUESTA:
{
"status_url": "https://sharpapi.com/api/v1/finance/parse_invoice/job/status/e00ebeec-6df3-4282-b515-8c447ea5d6ab",
"job_id": "e00ebeec-6df3-4282-b515-8c447ea5d6ab"
}
Paso 2. Monitorear y Obtener Resultados del Trabajo de IA
Endpoint: GET - /api/v1/finance/parse_invoice/job/status/:uuid
Un endpoint se utiliza para verificar el progreso del trabajo de API solicitado.
EJEMPLO DE RESULTADO:
{
"data": {
"type": "api_job_result",
"id": "e00ebeec-6df3-4282-b515-8c447ea5d6ab",
"attributes": {
"status": "success",
"type": "invoice_parse",
"result": [
{
"source_pages": [
1
],
"document": {
"type": "invoice",
"original_type_label": "Invoice",
"is_invoice": true,
"is_copy": false,
"copy_type": null
},
"invoice": {
"invoice_number": "D7BDFA00-0019",
"issue_date": "2025-12-07",
"due_date": "2025-12-07",
"document_date": null,
"order_date": null,
"delivery_date": null,
"shipping_date": null,
"pricing_date": null,
"currency": "USD",
"exchange_rate": null,
"page_info": "1 of 1",
"amount_in_words": "",
"notes": "",
"remarks": "",
"delivery_instructions": "",
"terms_and_conditions": [],
"late_payment_interest_rate": null
},
"references": {
"delivery_order_number": "",
"purchase_order_number": "",
"sales_order_number": "",
"customer_reference": "",
"external_document_number": "",
"grn_number": "",
"route_number": "",
"lorry_number": "",
"serial_number": "",
"batch_number": "",
"other_references": []
},
"e_invoice": {
"uuid": "",
"e_invoice_code": "",
"e_invoice_type": "",
"e_invoice_version": "",
"submission_id": "",
"submission_document_id": "",
"submission_long_id": "",
"submission_status": "",
"validation_datetime": null,
"digital_signature_present": false,
"validated_link": "",
"original_e_invoice_ref": "",
"qr_code_present": false
},
"seller": {
"name": "OpenAl, LLC",
"trade_name": "OpenAl",
"registration_number": "",
"tin": "",
"sst_id": "",
"gst_id": "",
"vat_id": "GB434338990",
"msic_code": "",
"business_activity": "",
"address": {
"street_line_1": "548 Market Street",
"street_line_2": "PMB 97273",
"city": "San Francisco",
"state": "California",
"postcode": "94104-5401",
"country": "US"
},
"phone": "",
"fax": "",
"email": "",
"website": "",
"bank_details": [
{
"bank_name": "",
"account_name": "",
"account_number": "",
"sort_code": "",
"swift_code": "",
"iban": ""
}
],
"contact_person": {
"name": "",
"role": "",
"phone": "",
"email": ""
}
},
"buyer": {
"name": "A2Z WEB LTD",
"trade_name": "",
"registration_number": "",
"tin": "",
"brn": "",
"sst_id": "",
"gst_id": "",
"vat_id": "",
"customer_account_number": "",
"billing_address": {
"location_name": "",
"street_line_1": "Unit 10 Enterprise Court, Farfield",
"street_line_2": "Park",
"city": "Rotherham",
"state": "",
"postcode": "S63 5DB",
"country": "GB"
},
"delivery_address": {
"recipient_name": "",
"location_name": "",
"street_line_1": "Unit 10 Enterprise Court",
"street_line_2": "Farfield Park",
"city": "Rotherham",
"state": "",
"postcode": "S63 5DB",
"country": "GB"
},
"delivery_address_same_as_billing": false,
"phone": "",
"fax": "",
"email": "",
"attention_to": {
"name": "",
"phone": "",
"email": ""
}
},
"sales_info": {
"salesperson_name": "",
"salesperson_code": "",
"salesperson_phone": "",
"sales_agent": "",
"sales_location": "",
"sales_department": "",
"outlet_name": ""
},
"financials": {
"subtotal": 15.57,
"gross_amount": null,
"total_discount_amount": null,
"shipping_charge": null,
"delivery_fee": null,
"total_excl_tax": 15.57,
"total_tax_amount": 3.11,
"service_tax_amount": null,
"total_incl_tax": 18.68,
"rounding_adjustment": null,
"total_payable": 18.68,
"amount_paid": null,
"amount_due": 18.68,
"tax_details": [
{
"tax_type": "VAT",
"tax_rate": 20,
"taxable_amount": 15.57,
"tax_amount": 3.11
}
]
},
"line_items": [
{
"line_number": 1,
"item_code": "",
"stock_code": "",
"barcode": "",
"description": "Crédito de uso de API de OpenAl",
"classification_code": "",
"country_of_origin": "",
"quantity": 1,
"free_quantity": null,
"unit_of_measure": "",
"unit_of_measure_raw": "",
"pack_size": "",
"total_units": null,
"weight": null,
"weight_uom": "",
"unit_price": 15.57,
"discount_percent": null,
"discount_amount": null,
"subtotal": 15.57,
"tax_rate": 20,
"tax_type": "VAT",
"tax_amount": 3.11,
"total_excl_tax": 15.57,
"total_incl_tax": null,
"expiry_date": null,
"batch_lot_number": "",
"service_start_date": null,
"service_end_date": null
}
],
"payment": {
"payment_terms": "",
"payment_terms_days": null,
"payment_method": "",
"payment_date": null,
"payment_reference": "",
"jompay_biller_code": "",
"jompay_ref_1": ""
},
"logistics": {
"shipping_method": "",
"vehicle_number": "",
"driver_name": "",
"delivery_zone": "",
"delivery_time_constraint": "",
"carton_count": null,
"total_volume": null,
"total_weight": null,
"goods_received_confirmation": false,
"received_by": "",
"receiver_signature_present": false
}
}
]
}
}
}
- Palabras clave relacionadas:
- Factura
- Analizador
- Análisis de IA
- Análisis de facturas