La API de Toku responderá con errores que siguen una estructura definida para los recursos de Customers, Subscriptions e Invoices. Los mensajes de error tendrán el siguiente formato:

{  
   "error":{  
      "message":"Some descriptive message.",  
      "code":"TKXXXX"  
   }  
}

El propósito de esta sección es comprender la estructura del campo code dentro de la respuesta de la API, proporcionando un catálogo que enumera los posibles códigos que la API puede devolver junto con sus correspondientes descripciones.

Estructura del código de error

Los errores tendrán la siguiente sintáxis

Con las siguientes fuentes:

Type	Code
No Explicit Type	0
Expected	1
Database	2
Validation	3

Entity	Code
No entity	00
Country	01
Organization	02
Account	03
Customer	04
Subscription	05
Invoice	06
PaymentMethod	07
Payment	09

Listado de códigos (por entidad)

Sin Entidad

Código Toku	Descripción
TK30000	Error de validación, la validación del request falló.

Country

Código Toku	Descripción
TK30100	El país no está soportado para la validación de identificaciones oficiales.

Customer

Código Toku	Descripción
TK20400	Cliente no encontrado en la base de datos.
TK30400	El payload del cliente no incluye su identificador externo.
TK30401	El `external_id` del cliente no coincide con el parámetro `customer_external_id_parameter` de la organización.
TK30402	El `government_id` del cliente es inválido.
TK30403	La preferencia de teléfono del cliente es inválida.
TK30404	El número de teléfono del cliente es inválido.
TK30405	El email del cliente tiene una sintaxis inválida.
TK30406	El email del cliente está en una lista negra.
TK30407	Hubo un conflicto lógico en el flujo de eliminación del cliente.
TK30408	El código de país del número telefónico del cliente no es soportado por Toku.
TK30409	No se encontró el cliente por su `external_id`.
TK30410	El cliente ya existe en una operación donde no está permitido.
TK00499	Error interno al intentar guardar el cliente.

Subscriptions

Código Toku	Descripción
TK20500	Suscripción no encontrada en la base de datos.
TK20501	No se encontró una suscripción para el cliente dado.
TK30500	Conflicto lógico al intentar eliminar la suscripción.
TK30501	Se intentó transferir la suscripción a un cliente distinto.
TK30502	Conflicto lógico al intentar editar la suscripción.
TK30503	La suscripción no tiene todos los campos requeridos.
TK30504	Conflicto lógico al intentar crear la suscripción.
TK30504	La suscripción ya existe en una operación donde no está permitido.
TK00599	Error interno al intentar guardar la subscripción.

Invoices

Código Toku	Descripción
TK20600	Factura no encontrada en la base de datos.
TK20601	No se encontró una factura para un cliente específico.
TK30600	Conflicto lógico al intentar eliminar la factura.
TK30601	Conflicto lógico al intentar crear la factura.
TK30602	Conflicto lógico al intentar anular la factura.
TK30603	Conflicto lógico al intentar editar la factura.
TK30604	La factura ya existe en una operación donde no está permitido.
TK00699	Error interno al intentar guardar la factura.