Falhas batch de entidades
curl --request GET \
--url http://api.gu1.ai/batch-import/entity-jobs/{jobId}/failures \
--header 'Authorization: Bearer <token>'import requests
url = "http://api.gu1.ai/batch-import/entity-jobs/{jobId}/failures"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('http://api.gu1.ai/batch-import/entity-jobs/{jobId}/failures', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "http://api.gu1.ai/batch-import/entity-jobs/{jobId}/failures",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "http://api.gu1.ai/batch-import/entity-jobs/{jobId}/failures"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("http://api.gu1.ai/batch-import/entity-jobs/{jobId}/failures")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("http://api.gu1.ai/batch-import/entity-jobs/{jobId}/failures")
http = Net::HTTP.new(url.host, url.port)
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_bodyReferência API
Falhas batch de entidades
Baixe em CSV ou JSON as linhas com falha e skips de um job bulk de entidades, com motivos de erro por linha para reprocessar na API batch da gu1.
GET
/
batch-import
/
entity-jobs
/
{jobId}
/
failures
Falhas batch de entidades
curl --request GET \
--url http://api.gu1.ai/batch-import/entity-jobs/{jobId}/failures \
--header 'Authorization: Bearer <token>'import requests
url = "http://api.gu1.ai/batch-import/entity-jobs/{jobId}/failures"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text)const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('http://api.gu1.ai/batch-import/entity-jobs/{jobId}/failures', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));<?php
$curl = curl_init();
curl_setopt_array($curl, [
CURLOPT_URL => "http://api.gu1.ai/batch-import/entity-jobs/{jobId}/failures",
CURLOPT_RETURNTRANSFER => true,
CURLOPT_ENCODING => "",
CURLOPT_MAXREDIRS => 10,
CURLOPT_TIMEOUT => 30,
CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1,
CURLOPT_CUSTOMREQUEST => "GET",
CURLOPT_HTTPHEADER => [
"Authorization: Bearer <token>"
],
]);
$response = curl_exec($curl);
$err = curl_error($curl);
curl_close($curl);
if ($err) {
echo "cURL Error #:" . $err;
} else {
echo $response;
}package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "http://api.gu1.ai/batch-import/entity-jobs/{jobId}/failures"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("Authorization", "Bearer <token>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}HttpResponse<String> response = Unirest.get("http://api.gu1.ai/batch-import/entity-jobs/{jobId}/failures")
.header("Authorization", "Bearer <token>")
.asString();require 'uri'
require 'net/http'
url = URI("http://api.gu1.ai/batch-import/entity-jobs/{jobId}/failures")
http = Net::HTTP.new(url.host, url.port)
request = Net::HTTP::Get.new(url)
request["Authorization"] = 'Bearer <token>'
response = http.request(request)
puts response.read_bodyEndpoints
GET https://api.gu1.ai/batch-import/entity-jobs/{jobId}/failures.csv
GET https://api.gu1.ai/batch-import/entity-jobs/{jobId}/failures
GET https://api.gu1.ai/entities/automatic/bulk/imports/{jobId}/failures.csv
…/failures.csv→ download CSV (somente linhasfailed)…/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
Authorization: Bearer SUA_API_KEY
transactions:create, entities:bulk_import, events:create.
Respostas HTTP
| Código | Quando |
|---|---|
200 | Job encontrado |
401 | Sem autenticação |
403 | Sem permissão |
404 | Job não encontrado |
Colunas CSV (failures.csv)
Somente linhas com outcome=failed.
| Coluna | Descrição |
|---|---|
tax_id | Tax id da linha |
type | person ou company |
outcome | Sempre failed neste export |
code | Código estável — catálogo |
error_message | Detalhe legível |
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
Incluifailures[] (somente failed) e, se aplicável, skips[] / skipsTotal (linhas omitidas, não erros).
{
"success": true,
"jobId": "…",
"kind": "entity_batch",
"status": "completed",
"totalItems": 100,
"succeeded": 97,
"failed": 2,
"skipped": 1,
"failures": [
{
"taxId": "20123456789",
"type": "company",
"outcome": "failed",
"code": "DUPLICATE_EXTERNAL_ID",
"message": "An entity with external ID \"X\" already exists…"
}
],
"truncated": false,
"failuresTotal": 2,
"skips": [
{
"taxId": "30111222333",
"type": "person",
"outcome": "skipped_existing",
"code": "SKIPPED_DUPLICATE_TAX_ID"
}
],
"skipsTotal": 1
}
| Código skip | Significado |
|---|---|
SKIPPED_DUPLICATE_TAX_ID | Bulk manual: taxId+tipo já existia |
SKIPPED_ENTITY_ALREADY_EXISTS | Bulk automático: entidade já existia |
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.Was this page helpful?