Saptiva Document Extraction API

Authorization: Token <sk-saptiva-your_api_key>

{
  "error": "Mensaje de error legible",
  "code": "ERROR_CODE"
}

{
  "exitoso": true,
  "id": "saptiva_1704825600000_abc123",
  "tipo_documento": 1,
  "texto_extraido": "CONTRATO DE SERVICIOS COMERCIALES...\nCLÁUSULA PRIMERA...",
  "datos_extraidos": {
    "numero_contrato": {
      "value": "GAFSACOMM-0001-2025",
      "certainty": 1.0
    },
    "nombre_contraparte": {
      "value": "Empresa ABC S.A. de C.V.",
      "certainty": 1.0
    },
    "rfc_contraparte": {
      "value": "EAB123456XX0",
      "certainty": 0.8
    },
    "monto_afianzado": {
      "value": {
        "monto": 1500000,
        "porcentaje_aplicado": 10,
        "base_calculo": "10% del monto total del contrato",
        "moneda": "MXN"
      },
      "certainty": 1.0
    },
    "errors": {
      "hasError": false,
      "errorMessage": ""
    }
  },
  "mensaje": "Documento procesado exitosamente"
}

{
  "exitoso": false,
  "id": "saptiva_1704825600000_abc123",
  "tipo_documento": 1,
  "texto_extraido": null,
  "datos_extraidos": null,
  "mensaje": "Error procesando documento: No text extracted from document",
  "code": "TEXT_EXTRACTION_FAILED"
}

import requests

API_KEY = "sk-saptiva-your-key-here"
BASE_URL = "https://adjudicator.saptiva.com"

def extract_document(pdf_path, documento_id, expediente_id, tipo_documento, webhook_url):
    with open(pdf_path, 'rb') as f:
        response = requests.post(
            f"{BASE_URL}/api/extract/",
            headers={"Authorization": f"Token {API_KEY}"},
            files={"documento": f},
            data={
                "documento_id": documento_id,
                "expediente_id": expediente_id,
                "tipo_documento": tipo_documento,
                "webhook_url": webhook_url
            }
        )
    return response.json()

# Subir un contrato
result = extract_document(
    pdf_path="contract.pdf",
    documento_id="DOC-001",
    expediente_id="EXP-2026-001",
    tipo_documento=1,  # Contrato
    webhook_url="https://my-server.com/webhook"
)
print(f"Tracker ID: {result['tracker_id']}")

# Subir un acta constitutiva
result = extract_document(
    pdf_path="acta_constitutiva.pdf",
    documento_id="DOC-002",
    expediente_id="EXP-2026-001",
    tipo_documento=4,  # Acta Constitutiva
    webhook_url="https://my-server.com/webhook"
)
print(f"Tracker ID: {result['tracker_id']}")

from flask import Flask, request, jsonify

app = Flask(__name__)

@app.route('/webhook/receive', methods=['PUT'])
def receive_webhook():
    data = request.json

    if data.get('exitoso'):
        tracker_id = data['id']
        tipo = data['tipo_documento']
        extracted = data['datos_extraidos']

        # Procesar los datos extraídos
        print(f"Documento {tracker_id} procesado exitosamente")
        print(f"Campos extraídos: {list(extracted.keys())}")
    else:
        print(f"Procesamiento fallido: {data['mensaje']}")

    # Responde 2xx para confirmar la entrega
    return jsonify({"status": "received"}), 200

if __name__ == '__main__':
    app.run(port=5001)