Errores

Cuando algo falla, la respuesta tiene un código 4xx o 5xx y este cuerpo (salvo el 503 de mantenimiento, que solo lleva message):

{
    "error": true,
    "message": "Faltan campos obligatorios o los datos son inválidos.",
    "details": {
        "invoice_lines.0.vat_rate": "El tipo de IVA es obligatorio."
    }
}

message explica el error. details solo aparece cuando faltan datos o no son válidos (400): indica qué campo falla y por qué. Por ejemplo, invoice_lines.0.vat_rate es el campo vat_rate de la primera línea.

Código	Qué significa	Qué hacer
400	Faltan datos o no son válidos, o el cuerpo no es un JSON válido.	Corregir la petición con lo que dice message y, si viene, details.
401	La clave de API no vale o no tiene permiso para esa acción. Consulta Errores de autenticación.	Corregir la clave. Reintentar no sirve.
404	Lo que se pide no existe, es de otra empresa o el id está mal escrito.	Comprobar el id.
409	No se puede hacer en el estado en que está. Por ejemplo, eliminar una factura emitida o emitir mientras TicketBAI confirma otra.	Leer message: explica el motivo.
413	El cuerpo de la petición es demasiado grande.	Enviar menos datos en cada petición.
429	Se ha superado un límite.	Leer message. En el límite de peticiones, esperar los segundos que indica Retry-After; en los límites de facturas o de emails, esperar al mes o al día siguiente.
500	Error inesperado de tukonta. El mensaje es siempre genérico.	Repetir más tarde. Si sigue pasando, contactar con tukonta.
503	Tukonta está en mantenimiento.	Esperar los segundos que indica Retry-After y repetir.