Enviar uma carga em lote

POST

/fhir/resources/Bundle

POST

/fhir/resources/Bundle

$ curl -X POST https://landing-zone-api.nilo.services/fhir/resources/Bundle \
>      -H "x-api-key: <apiKey>" \
>      -H "Content-Type: application/json" \
>      -d '{
>   "resourceType": "Bundle",
>   "type": "batch",
>   "entry": [
>     {
>       "request": {
>         "method": "POST",
>         "url": "Patient",
>         "ifNoneExist": "identifier=https://servicos.receita.fazenda.gov.br/servicos/cpf/|01234567890"
>       },
>       "resource": {
>         "resourceType": "Patient",
>         "birthDate": "1988-03-14",
>         "gender": "female",
>         "identifier": [
>           {
>             "system": "https://servicos.receita.fazenda.gov.br/servicos/cpf/",
>             "use": "usual",
>             "value": 1234567890
>           }
>         ],
>         "name": [
>           {
>             "text": "Ana Paula Ribeiro",
>             "use": "official"
>           }
>         ]
>       },
>       "fullUrl": "urn:uuid:123e4567-e89b-12d3-a456-426614174000"
>     },
>     {
>       "request": {
>         "method": "POST",
>         "url": "Patient",
>         "ifNoneExist": "identifier=https://servicos.receita.fazenda.gov.br/servicos/cpf/|98765432109"
>       },
>       "resource": {
>         "resourceType": "Patient",
>         "birthDate": "1975-11-02",
>         "gender": "male",
>         "identifier": [
>           {
>             "system": "https://servicos.receita.fazenda.gov.br/servicos/cpf/",
>             "use": "usual",
>             "value": "98765432109"
>           }
>         ],
>         "name": [
>           {
>             "text": "Carlos Eduardo Lima",
>             "use": "official"
>           }
>         ]
>       },
>       "fullUrl": "urn:uuid:987f6543-ba09-87dc-5678-0987654321ab"
>     }
>   ]
> }'

1 {
2   "resourceType": "Bundle",
3   "type": "batch-response",
4   "entry": [
5     {
6       "response": {
7         "status": "200 OK",
8         "location": "Patient/ba200cfa-dae0-46cf-81a0-008e3f7414b4"
9       }
10     },
11     {
12       "response": {
13         "status": "400 Bad Request",
14         "location": "urn:uuid:5c9a1e77-30bd-4f18-a2c6-71e4b0532d89",
15         "outcome": {
16           "issue": [
17             {
18               "code": "not-found",
19               "details": {
20                 "text": "Patient does not exist"
21               },
22               "expression": [
23                 "Condition.subject"
24               ],
25               "severity": "error"
26             }
27           ],
28           "resourceType": "OperationOutcome"
29         }
30       }
31     }
32   ],
33   "id": "30f8c1a5-27de-4b96-8071-4e5b93c0da26",
34   "meta": {
35     "lastUpdated": "2026-08-11T15:02:44.318000Z",
36     "versionId": "MTc4NjAyMTQ1MjkwNTAwMDM2Nw"
37   }
38 }

Executa várias escritas numa requisição só. Cada entrada é processada de forma independente: uma falha não interrompe as demais, e não há rollback. A resposta traz o resultado de cada entrada, na mesma ordem.

Authentication

x-api-keystring

API Key authentication via header

Request

This endpoint expects an object.

resourceTypestringRequiredDefaults to Bundle

Indica o tipo do recurso transacionado.

typestringRequiredformat: "^[^\s]+(\s[^\s]+)*$"

Obrigatório. batch é o valor a usar. transaction é aceito por compatibilidade e processado do mesmo jeito — não há atomicidade.

entrylist of objectsRequired

Uma entrada por escrita. Recomendamos no máximo 10 entradas por lote, idealmente cinco — não é um limite validado, é conselho de desempenho.

Response

O lote foi processado. Isto não quer dizer que as entradas deram certo — o resultado de cada uma está em entry[].response.status.

resourceTypestringDefaults to Bundle

Indica o tipo do recurso transacionado.

typestringformat: "^[^\s]+(\s[^\s]+)*$"

Constante batch-response — inclusive quando o pedido foi transaction.

entrylist of objectsRead-only

Uma entrada por entrada enviada, na mesma ordem.

idstringOptionalformat: "^[A-Za-z0-9\-\.]{1,64}$"

Identificador Nilo FHIR do resultado, que fica gravado e pode ser relido.

metaobjectOptional

Metadados da gravação no store.

Errors

400

Bad Request Error