Integración con Midaz

# Conexión con Midaz
MIDAZ_BASE_URL=https://api.midaz.example.com
MIDAZ_GRPC_ADDRESS=midaz-grpc.example.com:50051

# Autenticación (compartida con Midaz)
AUTH_SERVICE_URL=https://auth.example.com
AUTH_CLIENT_ID=matcher-service
AUTH_CLIENT_SECRET=your-secret

# Configuración de conexión
MIDAZ_CONNECTION_TIMEOUT=30s
MIDAZ_REQUEST_TIMEOUT=60s
MIDAZ_MAX_RETRIES=3

# El intercambio de tokens ocurre automáticamente
# Matcher solicita: POST /oauth/token
{
 "grant_type": "client_credentials",
 "client_id": "matcher-service",
 "client_secret": "your-secret",
 "scope": "ledger:read transactions:read"
}

X-Tenant-ID: tenant_001

{
  "date_from": "2024-01-01",
  "date_to": "2024-01-31",
  "filters": {
    "operation_types": [
      "CREDIT",
      "DEBIT"
    ],
    "min_amount": 100.0,
    "currencies": [
      "USD",
      "EUR"
    ],
    "metadata": {
      "source_system": "treasury"
    }
  }
}

{
  "settings": {
    "field_mapping": {
      "reference": "metadata.invoice_number",
      "counterparty": "metadata.vendor_name",
      "external_id": "metadata.bank_reference"
    }
  }
}

Base de datos: matcher_db
├── tenant_001 (esquema)
│ ├── transactions
│ ├── matches
│ └── exceptions
├── tenant_002 (esquema)
│ ├── transactions
│ ├── matches
│ └── exceptions
└── shared (esquema)
 ├── field_maps
 └── rules_templates

{
  "sub": "user_123",
  "tenant_id": "tenant_001",
  "roles": [
    "reconciliation_admin"
  ]
}

{
  "error": "MIDAZ_CONNECTION_ERROR",
  "message": "Error al conectar con Midaz en midaz-grpc.example.com:50051",
  "details": {
    "retry_count": 3,
    "last_error": "connection refused"
  },
  "suggestion": "Verifique la conectividad de red y el estado del servicio Midaz"
}

{
  "error": "MIDAZ_AUTH_ERROR",
  "message": "Error al autenticarse con Midaz",
  "details": {
    "status_code": 401,
    "reason": "invalid_client"
  },
  "suggestion": "Verifique las credenciales del cliente y los alcances requeridos"
}

{
  "error": "MIDAZ_SYNC_ERROR",
  "message": "Fallo parcial de sincronización",
  "details": {
    "total_expected": 5000,
    "fetched": 4500,
    "failed_batches": [
      {
        "batch": 10,
        "error": "timeout"
      }
    ]
  },
  "suggestion": "Reintente los lotes fallidos o aumente el tiempo de espera"
}