Skip to main content
GET
Falhas batch de entidades

Endpoints

Alias legacy CSV (mesmo arquivo):
  • …/failures.csv → download CSV (somente linhas failed)
  • …/failures → JSON (failures[] + skips[] quando aplicável)
Este endpoint também retorna status do job e contadores quando não há falhas por linha (failures: []). Para polling genérico em todos os tipos de import, prefira Consultar status do job batch.

Autenticação e permissões

Requer pelo menos um de: transactions:create, entities:bulk_import, events:create.

Respostas HTTP

Colunas CSV (failures.csv)

Somente linhas com outcome=failed.
Duplicado por taxId (bulk manual default): mesmo taxId + mesmo tipo → skipped_existing, código SKIPPED_DUPLICATE_TAX_ID. Não aparece em failures.csv. Consulte JSON skips[] ou o relatório completo do job.

Resposta JSON

Inclui failures[] (somente failed) e, se aplicável, skips[] / skipsTotal (linhas omitidas, não erros).
failures.csv contém somente linhas outcome=failed. Duplicados taxId omitidos aparecem em JSON skips[] e no relatório completo por email, não em failures.csv. Ver também: Importar entidades, Códigos de falha.