Códigos de erro
Cada código de erro indica o problema específico e ajuda você a tratar cenários previsíveis no seu integrador. O envelope é sempre o mesmo: { error: { code, message } }.
Autenticação
| Status | Código | Quando ocorre |
|---|---|---|
| 401 | invalid_iopoint_token | Token ausente, malformado, inválido ou de empresa inativa. |
Validação
| Status | Código | Quando ocorre |
|---|---|---|
| 422 | date_range_exceeded | Período entre begin_date e end_date superior a 31 dias. |
| 422 | date_time_greater_than_now | datetime de registro de ponto está no futuro. |
| 422 | date_begin_less_than_now | datetime de registro de ponto anterior à data de admissão. |
| 422 | collaborator_fired | Único colaborador encontrado com o CPF informado está demitido (dismissal_date preenchida); operação bloqueada (registro de ponto, upload de foto, etc.). |
| 422 | dismissal_date_before_admission_date | dismissal_date anterior à data de admissão do colaborador. |
Recurso não encontrado
| Status | Código | Quando ocorre |
|---|---|---|
| 404 | not_found | Recurso genérico inexistente ou de outra empresa. |
| 404 | company_not_found | company_national_registry (CNPJ) não pertence ao grupo econômico acessível pela matriz. |
| 404 | point_not_found | Ponto inexistente ou de outra empresa (GET /point/audit). |
| 404 | audit_photo_not_found | Ponto existe, mas não há foto de auditoria associada. |
| 404 | collaborator_not_found | Colaborador inexistente, inativo ou de outra empresa. |
| 404 | cpf_not_found | CPF informado não está cadastrado. |
| 404 | journey_not_found | journey_id inválido. |
| 404 | cost_center_not_found | cost_center_id inválido. |
| 404 | department_not_found | department_id inválido. |
| 404 | unit_not_found | unit_id inválido. |
| 404 | collaborator_settings_not_found | collaborator_settings_id inválido. |
| 404 | point_rule_not_found | point_rule_id inválido. |
| 404 | fired_type_not_found | fired_type_id inválido. |
| 404 | absence_type_not_found | absence_type_id inválido. |