Validar un archivo de lotes del producto
Contrato de las versiones instaladas. Para treasury, el Excel contiene user_name y amount; para bonuses, phone_number y amount. Los beneficiarios se resuelven dentro del tenant y moneda. Los teléfonos repetidos se agrupan y comparten una sola cuenta; las altas nuevas siguen sin verificar y sin país inferido. Una billetera ausente o ambigua rechaza la fila y no crea otra cuenta. Si un alta queda pendiente, ROW_VALIDATION_FAILED incluye registration_pending; una nueva validación retoma esa misma alta. Una dependencia no disponible devuelve 503 y nunca equivale a persona nueva. Subir y validar no reserva ni mueve dinero: el disparo posterior del lote es una operación separada. No se garantiza que subir otra vez el archivo devuelva el mismo batch_id.
Authorization
productSession Sesión del usuario del producto Tikin, con headers Tenant y Account; distinta del token de tenant de plataforma.
In: header
Path Parameters
Value in
- "tikin"
- "beu"
Header Parameters
La versión del contrato a la que anclas este pedido, como fecha YYYY-MM-DD. Rige la última publicada en o antes de esa fecha; sin el header, la más reciente.
dateValue in
- "tikin"
- "beu"
uuidLlave conservada en el lote para su ejecución posterior.
Request Body
multipart/form-data
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
curl -X POST "https://example.com/payment-batch/tikin/process-batch" \ -H "Tenant: tikin" \ -H "Account: 497f6eca-6276-4993-bfeb-53cbbbba6f08" \ -H "Idempotency-Key: string" \ -F process="treasury" \ -F currency="COP" \ -F file="string"{ "batch_id": "4da22c97-b7d5-4e31-8c3a-03870ebc7b20", "process": "treasury", "account_id": "449e7a5c-69d3-4b8a-aaaf-5c9b713ebc65", "currency": "COP", "status_file_validator": "COMPLETED", "status_transactions": "PENDING", "total_amount_file": 0, "total_accounts_file": 0, "total_transactions_file": 0}