Saltar al contenido principal
POST
/
v1
/
textify
/
analyzer
curl --request POST \
  --url https://textify-api.argosidentity.com/v1/textify/analyzer \
  --header 'Content-Type: application/json' \
  --header 'x-api-key: <api-key>' \
  --data '
{
  "fileExtension": "PDF",
  "docuType": "InvoiceMedical",
  "fileData": "base64-encoded-file-data"
}
'
{
  "status": "success",
  "data": {
    "patientName": "John Doe",
    "hospitalName": "City General Hospital",
    "totalAmount": 1500,
    "services": [
      {
        "service": "Consultation",
        "amount": 200
      },
      {
        "service": "Lab Test",
        "amount": 300
      }
    ]
  },
  "confidence": 0.95
}
La plantilla de facturas generales extrae datos estructurados de facturas comerciales estándar de empresas y proveedores de servicios, incluyendo número de factura, datos del cliente, artículos/servicios e información de pago.

​
Características de la plantilla

Extrae la siguiente información de facturas generales:
  • Metadatos e identificación de la factura
  • Información del cliente y del proveedor
  • Líneas de artículos y detalles de servicios
  • Precios y términos de pago
  • Cálculos de impuestos y totales
  • Métodos de pago y fechas de vencimiento

​
Ejemplo de uso

{
  "fileExtension": "pdf",
  "docuType": "InvoiceGeneral",
  "fileData": "base64-encoded-general-invoice-data"
}

​
Formato de respuesta

La plantilla devuelve datos estructurados de facturas generales que incluyen:

​
Información de la factura

  • Invoice Number: Identificador único de la factura
  • Issue Date: Fecha de creación de la factura
  • Due Date: Fecha límite de pago
  • Payment Terms: Condiciones y términos de pago

​
Información del cliente

  • Customer Name: Nombre del cliente
  • Customer Address: Dirección completa del cliente
  • Contact Person: Contacto principal del cliente
  • Contact Information: Correo electrónico y números de teléfono

​
Información del proveedor

  • Vendor Name: Nombre del proveedor de servicios o vendedor
  • Vendor Address: Dirección completa del proveedor
  • Contact Information: Datos de contacto del proveedor
  • Tax ID: Número de identificación fiscal del proveedor

​
Líneas de artículos

  • Service Description: Descripción detallada del servicio o producto
  • Quantity: Número de unidades u horas
  • Unit Price: Precio por unidad u hora
  • Total: Monto total de la línea
  • Tax Rate: Porcentaje de impuesto aplicable

​
Detalles financieros

  • Subtotal: Suma antes de impuestos
  • Tax Amount: Impuesto total calculado
  • Total Amount: Monto final de la factura
  • Currency: Moneda de la factura
  • Payment Methods: Opciones de pago aceptadas

​
Respuesta de ejemplo

{
  "status": "success",
  "data": {
    "document": {
      "invoiceInfo": {
        "invoiceNumber": "INV-2024-001",
        "issueDate": "2024-01-15",
        "dueDate": "2024-02-15",
        "paymentTerms": "Net 30"
      },
      "customerInfo": {
        "name": "ABC Company",
        "address": "789 Corporate Blvd, Business City, BC 67890",
        "contactPerson": "Jane Manager",
        "email": "accounts@abccompany.com"
      },
      "vendorInfo": {
        "name": "Professional Services Inc.",
        "address": "123 Service Lane, Provider City, PC 12345",
        "contactNumber": "+1-555-9876"
      },
      "lineItems": [
        {
          "description": "Website Development Services",
          "quantity": 1,
          "unitPrice": 5000.00,
          "total": 5000.00
        },
        {
          "description": "SEO Optimization",
          "quantity": 1,
          "unitPrice": 1500.00,
          "total": 1500.00
        }
      ],
      "totals": {
        "subtotal": 6500.00,
        "taxRate": 0.08,
        "taxAmount": 520.00,
        "totalAmount": 7020.00
      }
    },
    "confidence": 0.91
  }
}

​
Tipos de facturas generales compatibles

  • Facturas de proveedores de servicios
  • Facturas de servicios de consultoría
  • Facturas de servicios profesionales
  • Facturas de servicios de mantenimiento
  • Facturas de licencias de software
  • Facturas de alquiler de equipos
  • Facturas de servicios de capacitación
  • Facturas de servicios de marketing
  • Facturas de servicios legales
  • Facturas de servicios contables

Autorizaciones

​
x-api-key
string
header
requerido

Cuerpo

application/json
​
fileExtension
enum<string>
requerido

The file extension of the document to be analyzed. Must be one of the supported formats.

Opciones disponibles:
PDF,
TIFF,
JPG,
PNG
​
docuType
enum<string>
requerido

The type of document to be analyzed. This determines the extraction model and data structure used for analysis.

Supported Document Types:

  • InvoiceMedical: Medical invoices and bills from healthcare providers, hospitals, clinics, and medical facilities. Extracts patient information, medical services, costs, and billing details.
  • BusinessRegistration: Official business registration documents, corporate certificates, and company formation papers. Extracts business name, registration number, business type, and address information.
  • InvoiceGeneral: Standard commercial invoices from businesses and service providers. Extracts invoice number, customer details, items/services, and payment information.
  • MedicalObservation: Medical reports, patient records, and clinical observation documents. Extracts patient data, medical findings, diagnosis, and treatment information.
  • Contract: Legal contracts, agreements, and binding documents between parties. Extracts contract terms, parties involved, dates, and legal obligations.
  • ArrivalNotice: Shipping and logistics arrival notifications, delivery confirmations. Extracts shipment details, arrival dates, and delivery information.
  • BillofLading: Transportation documents for cargo and freight shipments. Extracts shipping details, cargo information, and transport terms.
  • Jobapplication: Employment applications, resumes, and job-related documents. Extracts applicant information, qualifications, and employment history.
  • BalanceCertificate_KR: Korean bank balance certificates and financial statements. Extracts account information, balance details, and banking data.
  • ProofOfAddress: Address verification documents, utility bills, and residence certificates. Extracts address information and verification details.
Opciones disponibles:
InvoiceMedical,
BusinessRegistration,
InvoiceGeneral,
MedicalObservation,
Contract,
ArrivalNotice,
BillofLading,
Jobapplication,
BalanceCertificate_KR,
ProofOfAddress
​
fileData
string
requerido

The base64 encoded data of the file to be analyzed. The file should be encoded without line breaks or additional formatting.

Respuesta

Successful analysis

​
status
string

The status of the analysis operation. Returns 'success' when the document analysis is completed successfully.

Ejemplo:

"success"

​
data
object

Extracted structured data from the document

Ejemplo:
{
  "patientName": "John Doe",
  "hospitalName": "City General Hospital",
  "totalAmount": 1500,
  "services": [
    { "service": "Consultation", "amount": 200 },
    { "service": "Lab Test", "amount": 300 }
  ]
}
​
confidence
number

Confidence score of the extraction, ranging from 0.0 to 1.0. Higher values indicate more reliable extraction results.

Ejemplo:

0.95