{
    "variable": [
        {
            "id": "baseUrl",
            "key": "baseUrl",
            "type": "string",
            "name": "string",
            "value": "https:\/\/api.fardacontrol.com.br"
        }
    ],
    "info": {
        "name": "FardaControl \u2014 API de Integra\u00e7\u00e3o",
        "_postman_id": "700b1089-7d7c-4551-843c-48c0ddee7ca5",
        "description": "Esta \u00e9 a API **p\u00fablica de integra\u00e7\u00e3o** do FardaControl. Ela \u00e9 somente leitura:\r\ntodos os endpoints s\u00e3o `GET`. Qualquer outro verbo responde `405`.\r\n\r\n## Autentica\u00e7\u00e3o\r\n\r\nToda requisi\u00e7\u00e3o precisa de um token, enviado no header:\r\n\r\n```\r\nAuthorization: Bearer SEU_TOKEN\r\n```\r\n\r\nO token \u00e9 emitido por um administrador (da equipe do FardaControl ou da pr\u00f3pria\r\nempresa) e vale para uma empresa, com data de expira\u00e7\u00e3o definida na emiss\u00e3o.\r\n\r\nGuarde-o como uma senha: quem tem o token tem o acesso. Se vazar, pe\u00e7a a\r\nrevoga\u00e7\u00e3o \u2014 ela vale na requisi\u00e7\u00e3o seguinte e n\u00e3o afeta outros integradores.\r\n\r\n## Empresa\r\n\r\nO token j\u00e1 sabe a que empresa pertence. O header `X-Empresa-Id` \u00e9 opcional e s\u00f3\r\nfaz sentido se o seu acesso cobrir mais de uma empresa.\r\n\r\n## Pagina\u00e7\u00e3o\r\n\r\nListagens aceitam `page` e `per_page` (padr\u00e3o 50, m\u00e1ximo 200) e respondem no\r\nformato:\r\n\r\n```json\r\n{\r\n  \"data\": [ ... ],\r\n  \"meta\": { \"page\": 1, \"per_page\": 50, \"total\": 1234, \"last_page\": 25 }\r\n}\r\n```\r\n\r\n## Sincroniza\u00e7\u00e3o incremental\r\n\r\nEm vez de baixar tudo a cada carga, use `atualizado_desde` com o maior\r\n`atualizado_em` que voc\u00ea j\u00e1 importou:\r\n\r\n```\r\nGET \/api\/v1\/integracao\/funcionarios?atualizado_desde=2026-09-01T00:00:00-03:00\r\n```\r\n\r\nEnvie sempre o fuso expl\u00edcito: data sem fuso \u00e9 lida como UTC, e quem est\u00e1 em\r\nhor\u00e1rio de Bras\u00edlia perde 3 horas de registros na virada do dia.\r\n\r\nOs resultados v\u00eam ordenados por `atualizado_em` crescente \u2014 paginar at\u00e9 o fim e\r\nguardar o \u00faltimo valor \u00e9 um cursor seguro.\r\n\r\n**Movimentos de estoque s\u00e3o a exce\u00e7\u00e3o**: aquela tabela \u00e9 append-only e n\u00e3o tem\r\n`atualizado_em`. L\u00e1 a sincroniza\u00e7\u00e3o \u00e9 por `desde_id`, guardando o maior `id`\r\nimportado \u2014 um cursor exato, sem risco de pular registro.\r\n\r\n## Limites\r\n\r\n300 requisi\u00e7\u00f5es por minuto, por token. Ao estourar, a resposta \u00e9 `429` \u2014 espere\r\ne tente de novo.\r\n\r\n## Erros\r\n\r\nTodo erro tem a mesma forma:\r\n\r\n```json\r\n{ \"error\": \"codigo_legivel_por_maquina\", \"message\": \"Explica\u00e7\u00e3o em portugu\u00eas.\" }\r\n```\r\n\r\n| C\u00f3digo HTTP | `error` | O que fazer |\r\n|---|---|---|\r\n| 401 | `nao_autenticado` | Token ausente, inv\u00e1lido ou expirado |\r\n| 403 | `escopo_insuficiente` | O token n\u00e3o tem escopo para isso |\r\n| 403 | `acesso_negado` | O acesso n\u00e3o cobre este recurso |\r\n| 403 | `token_fora_de_escopo` | Voc\u00ea chamou uma rota fora de `\/api\/v1\/integracao\/` |\r\n| 404 | `nao_encontrado` | Registro inexistente ou de outra empresa |\r\n| 422 | `data_invalida` \/ `valor_invalido` | Corrija o par\u00e2metro; a mensagem diz o aceito |\r\n| 429 | `limite_excedido` | Reduza a frequ\u00eancia |\r\n\r\n## Dados pessoais\r\n\r\nO CPF \u00e9 devolvido completo. O cadastro de funcion\u00e1rio tem origem no pr\u00f3prio\r\nsistema do cliente, ent\u00e3o a API est\u00e1 devolvendo o dado a quem j\u00e1 \u00e9 dono dele.\r\n\r\nTodo acesso fica registrado (token, filtros usados, data e IP).",
        "schema": "https:\/\/schema.getpostman.com\/json\/collection\/v2.1.0\/collection.json"
    },
    "item": [
        {
            "name": "Ajustes de estoque",
            "description": "",
            "item": [
                {
                    "name": "Listar ajustes de estoque",
                    "request": {
                        "url": {
                            "host": "{{baseUrl}}",
                            "path": "api\/v1\/integracao\/ajustes-estoque",
                            "query": [
                                {
                                    "key": "de",
                                    "value": "2026-08-01",
                                    "description": "Data inicial do ajuste.",
                                    "disabled": false
                                },
                                {
                                    "key": "ate",
                                    "value": "2026-08-31",
                                    "description": "Data final, inclusiva.",
                                    "disabled": false
                                },
                                {
                                    "key": "atualizado_desde",
                                    "value": "2026-09-01T00%3A00%3A00-03%3A00",
                                    "description": "S\u00f3 registros alterados a partir desta data.",
                                    "disabled": false
                                },
                                {
                                    "key": "page",
                                    "value": "1",
                                    "description": "P\u00e1gina.",
                                    "disabled": false
                                },
                                {
                                    "key": "per_page",
                                    "value": "50",
                                    "description": "Itens por p\u00e1gina (1 a 200).",
                                    "disabled": false
                                }
                            ],
                            "raw": "{{baseUrl}}\/api\/v1\/integracao\/ajustes-estoque?de=2026-08-01&ate=2026-08-31&atualizado_desde=2026-09-01T00%3A00%3A00-03%3A00&page=1&per_page=50"
                        },
                        "method": "GET",
                        "header": [
                            {
                                "key": "Content-Type",
                                "value": "application\/json"
                            },
                            {
                                "key": "Accept",
                                "value": "application\/json"
                            }
                        ],
                        "body": null,
                        "description": "Segundo maior gerador de movimento depois da entrega, e o \u00fanico cujo\nmotivo n\u00e3o est\u00e1 em documento nenhum: ajuste n\u00e3o tem pedido, fornecedor\nnem funcion\u00e1rio. O que explica \u00e9 a `observacoes` e o `responsavel`.\n\nCada item traz `antes`, `depois` e `diferenca`. Os tr\u00eas, porque a\ndiferen\u00e7a sozinha n\u00e3o distingue os casos: `-3` pode ser \"tinha 10, virou\n7\" ou \"tinha 3, virou 0\" \u2014 a segunda \u00e9 ruptura de estoque."
                    },
                    "response": [
                        {
                            "header": [],
                            "code": 200,
                            "body": "{\n  \"data\": [{\n    \"id\": 2200,\n    \"data\": \"2026-08-20\",\n    \"observacoes\": \"Acerto ap\u00f3s contagem f\u00edsica do dia 20\",\n    \"responsavel\": {\"id\": \"0b14efad-\u2026\", \"nome\": \"MARIA ESTOQUISTA\"},\n    \"itens\": [{\n      \"id\": 5701,\n      \"item\": {\"id\": 34, \"nome\": \"CAL\u00c7A SOCIAL MASCULINA\", \"codigo\": \"000020\"},\n      \"grade\": {\"id\": 155, \"tamanho\": \"42\", \"cor\": null, \"marca\": \"PADR\u00c3O\"},\n      \"tipo_estoque\": \"novo\",\n      \"quantidade\": {\"antes\": 10, \"depois\": 7, \"diferenca\": -3},\n      \"valor_unitario\": 53,\n      \"valor_total\": -159\n    }],\n    \"empresa_id\": 1,\n    \"criado_em\": \"2026-08-20T11:02:00-03:00\",\n    \"atualizado_em\": \"2026-08-20T11:02:00-03:00\"\n  }],\n  \"meta\": {\"page\": 1, \"per_page\": 50, \"total\": 2200, \"last_page\": 44}\n}",
                            "name": "sucesso"
                        }
                    ]
                },
                {
                    "name": "Obter um ajuste de estoque",
                    "request": {
                        "url": {
                            "host": "{{baseUrl}}",
                            "path": "api\/v1\/integracao\/ajustes-estoque\/:ajuste",
                            "query": [],
                            "raw": "{{baseUrl}}\/api\/v1\/integracao\/ajustes-estoque\/:ajuste",
                            "variable": [
                                {
                                    "id": "ajuste",
                                    "key": "ajuste",
                                    "value": "2200",
                                    "description": "ID do ajuste."
                                }
                            ]
                        },
                        "method": "GET",
                        "header": [
                            {
                                "key": "Content-Type",
                                "value": "application\/json"
                            },
                            {
                                "key": "Accept",
                                "value": "application\/json"
                            }
                        ],
                        "body": null,
                        "description": ""
                    },
                    "response": [
                        {
                            "header": [
                                {
                                    "key": "cache-control",
                                    "value": "no-cache, private"
                                },
                                {
                                    "key": "content-type",
                                    "value": "application\/json"
                                },
                                {
                                    "key": "vary",
                                    "value": "Origin"
                                }
                            ],
                            "code": 401,
                            "body": "{\"error\":\"nao_autenticado\",\"message\":\"Token ausente, inv\\u00e1lido ou expirado. Envie Authorization: Bearer <token>.\"}",
                            "name": ""
                        },
                        {
                            "header": [],
                            "code": 404,
                            "body": "{\"error\": \"nao_encontrado\", \"message\": \"Ajuste n\u00e3o encontrado.\"}",
                            "name": "n\u00e3o encontrado ou de outra empresa"
                        }
                    ]
                }
            ]
        },
        {
            "name": "Entradas",
            "description": "",
            "item": [
                {
                    "name": "Listar entradas",
                    "request": {
                        "url": {
                            "host": "{{baseUrl}}",
                            "path": "api\/v1\/integracao\/entradas",
                            "query": [
                                {
                                    "key": "tipo",
                                    "value": "devolucao",
                                    "description": "`compra` ou `devolucao`.",
                                    "disabled": false
                                },
                                {
                                    "key": "status",
                                    "value": "Conclu%C3%ADda",
                                    "description": "Situa\u00e7\u00e3o da entrada. Aceita `Conclu\u00edda` ou `Cancelada`.",
                                    "disabled": false
                                },
                                {
                                    "key": "fornecedor_id",
                                    "value": "5",
                                    "description": "Filtra por fornecedor (s\u00f3 faz sentido em compra).",
                                    "disabled": false
                                },
                                {
                                    "key": "funcionario_id",
                                    "value": "25826",
                                    "description": "Filtra por funcion\u00e1rio (s\u00f3 faz sentido em devolu\u00e7\u00e3o).",
                                    "disabled": false
                                },
                                {
                                    "key": "de",
                                    "value": "2026-08-01",
                                    "description": "Data inicial.",
                                    "disabled": false
                                },
                                {
                                    "key": "ate",
                                    "value": "2026-08-31",
                                    "description": "Data final, inclusiva.",
                                    "disabled": false
                                },
                                {
                                    "key": "atualizado_desde",
                                    "value": "2026-09-01T00%3A00%3A00-03%3A00",
                                    "description": "S\u00f3 registros alterados a partir desta data.",
                                    "disabled": false
                                },
                                {
                                    "key": "page",
                                    "value": "1",
                                    "description": "P\u00e1gina.",
                                    "disabled": false
                                },
                                {
                                    "key": "per_page",
                                    "value": "50",
                                    "description": "Itens por p\u00e1gina (1 a 200).",
                                    "disabled": false
                                }
                            ],
                            "raw": "{{baseUrl}}\/api\/v1\/integracao\/entradas?tipo=devolucao&status=Conclu%C3%ADda&fornecedor_id=5&funcionario_id=25826&de=2026-08-01&ate=2026-08-31&atualizado_desde=2026-09-01T00%3A00%3A00-03%3A00&page=1&per_page=50"
                        },
                        "method": "GET",
                        "header": [
                            {
                                "key": "Content-Type",
                                "value": "application\/json"
                            },
                            {
                                "key": "Accept",
                                "value": "application\/json"
                            }
                        ],
                        "body": null,
                        "description": "Cobre duas coisas que o neg\u00f3cio trata como distintas, separadas pelo\ncampo `tipo`: `compra` (chegou do fornecedor) e `devolucao` (voltou de um\nfuncion\u00e1rio).\n\n**N\u00e3o existe recurso `devolucoes`** \u2014 devolu\u00e7\u00e3o \u00e9 uma entrada com\n`tipo=devolucao`, e em produ\u00e7\u00e3o \u00e9 a maioria delas. Somar entradas sem\nseparar por tipo mistura aquisi\u00e7\u00e3o com retorno e infla o que a empresa\nde fato comprou."
                    },
                    "response": [
                        {
                            "header": [],
                            "code": 200,
                            "body": "{\n  \"data\": [{\n    \"id\": 812,\n    \"data\": \"2026-08-19\",\n    \"tipo\": \"devolucao\",\n    \"status\": \"Conclu\u00edda\",\n    \"valor_total\": 106,\n    \"observacoes\": null,\n    \"fornecedor\": null,\n    \"funcionario\": {\"id\": 25826, \"nome\": \"JO\u00c3O SANTOS\", \"matricula\": \"006607\"},\n    \"pedido_fornecedor_id\": null,\n    \"entrega_emprestimo_id\": 73,\n    \"itens\": [{\n      \"id\": 1450,\n      \"item\": {\"id\": 34, \"nome\": \"CAL\u00c7A SOCIAL MASCULINA\", \"codigo\": \"000020\"},\n      \"grade\": {\"id\": 155, \"tamanho\": \"42\", \"cor\": null, \"marca\": \"PADR\u00c3O\"},\n      \"quantidade\": 2,\n      \"tipo_estoque\": \"higienizado\",\n      \"valor_unitario\": 53,\n      \"valor_total\": 106\n    }],\n    \"empresa_id\": 1,\n    \"criado_em\": \"2026-08-19T16:30:00-03:00\",\n    \"atualizado_em\": \"2026-08-19T16:30:00-03:00\"\n  }],\n  \"meta\": {\"page\": 1, \"per_page\": 50, \"total\": 1048, \"last_page\": 21}\n}",
                            "name": "sucesso"
                        }
                    ]
                },
                {
                    "name": "Obter uma entrada",
                    "request": {
                        "url": {
                            "host": "{{baseUrl}}",
                            "path": "api\/v1\/integracao\/entradas\/:entrada",
                            "query": [],
                            "raw": "{{baseUrl}}\/api\/v1\/integracao\/entradas\/:entrada",
                            "variable": [
                                {
                                    "id": "entrada",
                                    "key": "entrada",
                                    "value": "812",
                                    "description": "ID da entrada."
                                }
                            ]
                        },
                        "method": "GET",
                        "header": [
                            {
                                "key": "Content-Type",
                                "value": "application\/json"
                            },
                            {
                                "key": "Accept",
                                "value": "application\/json"
                            }
                        ],
                        "body": null,
                        "description": ""
                    },
                    "response": [
                        {
                            "header": [
                                {
                                    "key": "cache-control",
                                    "value": "no-cache, private"
                                },
                                {
                                    "key": "content-type",
                                    "value": "application\/json"
                                },
                                {
                                    "key": "vary",
                                    "value": "Origin"
                                }
                            ],
                            "code": 401,
                            "body": "{\"error\":\"nao_autenticado\",\"message\":\"Token ausente, inv\\u00e1lido ou expirado. Envie Authorization: Bearer <token>.\"}",
                            "name": ""
                        },
                        {
                            "header": [],
                            "code": 404,
                            "body": "{\"error\": \"nao_encontrado\", \"message\": \"Entrada n\u00e3o encontrada.\"}",
                            "name": "n\u00e3o encontrada ou de outra empresa"
                        }
                    ]
                }
            ]
        },
        {
            "name": "Entregas",
            "description": "",
            "item": [
                {
                    "name": "Listar entregas",
                    "request": {
                        "url": {
                            "host": "{{baseUrl}}",
                            "path": "api\/v1\/integracao\/entregas",
                            "query": [
                                {
                                    "key": "funcionario_id",
                                    "value": "25826",
                                    "description": "Filtra por funcion\u00e1rio.",
                                    "disabled": false
                                },
                                {
                                    "key": "cliente_id",
                                    "value": "543814",
                                    "description": "Filtra pela unidade\/contratante.",
                                    "disabled": false
                                },
                                {
                                    "key": "tipo",
                                    "value": "Renova%C3%A7%C3%A3o",
                                    "description": "Tipo da entrega.",
                                    "disabled": false
                                },
                                {
                                    "key": "cancelada",
                                    "value": "",
                                    "description": "Inclui s\u00f3 canceladas (`true`) ou s\u00f3 v\u00e1lidas (`false`).",
                                    "disabled": true
                                },
                                {
                                    "key": "de",
                                    "value": "2026-08-01",
                                    "description": "Data inicial (dia da entrega).",
                                    "disabled": false
                                },
                                {
                                    "key": "ate",
                                    "value": "2026-08-31",
                                    "description": "Data final, inclusiva.",
                                    "disabled": false
                                },
                                {
                                    "key": "atualizado_desde",
                                    "value": "2026-09-01T00%3A00%3A00-03%3A00",
                                    "description": "S\u00f3 registros alterados a partir desta data.",
                                    "disabled": false
                                },
                                {
                                    "key": "page",
                                    "value": "1",
                                    "description": "P\u00e1gina.",
                                    "disabled": false
                                },
                                {
                                    "key": "per_page",
                                    "value": "50",
                                    "description": "Itens por p\u00e1gina (1 a 200).",
                                    "disabled": false
                                }
                            ],
                            "raw": "{{baseUrl}}\/api\/v1\/integracao\/entregas?funcionario_id=25826&cliente_id=543814&tipo=Renova%C3%A7%C3%A3o&cancelada=&de=2026-08-01&ate=2026-08-31&atualizado_desde=2026-09-01T00%3A00%3A00-03%3A00&page=1&per_page=50"
                        },
                        "method": "GET",
                        "header": [
                            {
                                "key": "Content-Type",
                                "value": "application\/json"
                            },
                            {
                                "key": "Accept",
                                "value": "application\/json"
                            }
                        ],
                        "body": null,
                        "description": "Entregas canceladas V\u00caM na listagem por padr\u00e3o \u2014 o parceiro precisa saber\nque existiram para conciliar com o que j\u00e1 importou. Use `cancelada=false`\npara s\u00f3 o que vale.\n\nAten\u00e7\u00e3o a `assinatura`: `funcionario` \u00e9 a assinatura que prova\nrecebimento; `retirada` \u00e9 do supervisor que retirou o material. Contar\numa pela outra superestima o que foi de fato entregue \u00e0 pessoa."
                    },
                    "response": [
                        {
                            "header": [],
                            "code": 200,
                            "body": "{\n  \"data\": [{\n    \"id\": 73,\n    \"data_entrega\": \"2026-08-03\",\n    \"tipo\": \"Renova\u00e7\u00e3o\",\n    \"status\": \"Entregue\",\n    \"cancelada\": false,\n    \"motivo_cancelamento\": null,\n    \"valor_total\": 106,\n    \"parcial\": false,\n    \"funcionario\": {\"id\": 25826, \"nome\": \"JO\u00c3O SANTOS\", \"matricula\": \"006607\", \"cpf\": \"12345678909\"},\n    \"cliente\": {\"id\": 543814, \"nome\": \"CONDOM\u00cdNIO EXEMPLO\", \"origem\": \"entrega\"},\n    \"assinatura\": {\"funcionario\": true, \"retirada\": true},\n    \"devolucao\": {\"prevista_para\": null, \"devolvida_em\": null, \"status\": \"Pendente\"},\n    \"itens\": [{\n      \"id\": 140,\n      \"item\": {\"id\": 34, \"nome\": \"CAL\u00c7A SOCIAL MASCULINA\", \"codigo\": \"000020\"},\n      \"grade\": {\"id\": 155, \"tamanho\": \"42\", \"cor\": null, \"marca\": null},\n      \"quantidade\": 2,\n      \"tipo_estoque\": \"novo\",\n      \"valor_unitario\": 53,\n      \"valor_total\": 106\n    }],\n    \"empresa_id\": 1,\n    \"criado_em\": \"2026-08-03T09:12:00-03:00\",\n    \"atualizado_em\": \"2026-08-03T09:40:11-03:00\"\n  }],\n  \"meta\": {\"page\": 1, \"per_page\": 50, \"total\": 171, \"last_page\": 4}\n}",
                            "name": "sucesso"
                        }
                    ]
                },
                {
                    "name": "Obter uma entrega",
                    "request": {
                        "url": {
                            "host": "{{baseUrl}}",
                            "path": "api\/v1\/integracao\/entregas\/:entrega",
                            "query": [],
                            "raw": "{{baseUrl}}\/api\/v1\/integracao\/entregas\/:entrega",
                            "variable": [
                                {
                                    "id": "entrega",
                                    "key": "entrega",
                                    "value": "73",
                                    "description": "ID da entrega."
                                }
                            ]
                        },
                        "method": "GET",
                        "header": [
                            {
                                "key": "Content-Type",
                                "value": "application\/json"
                            },
                            {
                                "key": "Accept",
                                "value": "application\/json"
                            }
                        ],
                        "body": null,
                        "description": ""
                    },
                    "response": [
                        {
                            "header": [
                                {
                                    "key": "cache-control",
                                    "value": "no-cache, private"
                                },
                                {
                                    "key": "content-type",
                                    "value": "application\/json"
                                },
                                {
                                    "key": "vary",
                                    "value": "Origin"
                                }
                            ],
                            "code": 401,
                            "body": "{\"error\":\"nao_autenticado\",\"message\":\"Token ausente, inv\\u00e1lido ou expirado. Envie Authorization: Bearer <token>.\"}",
                            "name": ""
                        },
                        {
                            "header": [],
                            "code": 404,
                            "body": "{\"error\": \"nao_encontrado\", \"message\": \"Entrega n\u00e3o encontrada.\"}",
                            "name": "n\u00e3o encontrada ou de outra empresa"
                        }
                    ]
                }
            ]
        },
        {
            "name": "Funcion\u00e1rios",
            "description": "",
            "item": [
                {
                    "name": "Listar funcion\u00e1rios",
                    "request": {
                        "url": {
                            "host": "{{baseUrl}}",
                            "path": "api\/v1\/integracao\/funcionarios",
                            "query": [
                                {
                                    "key": "situacao",
                                    "value": "Ativo",
                                    "description": "Situa\u00e7\u00e3o cadastral. Aceita `Ativo` ou `Desligado`.",
                                    "disabled": false
                                },
                                {
                                    "key": "cargo_id",
                                    "value": "186960",
                                    "description": "Filtra por cargo.",
                                    "disabled": false
                                },
                                {
                                    "key": "cliente_id",
                                    "value": "543815",
                                    "description": "Filtra pela unidade\/contratante.",
                                    "disabled": false
                                },
                                {
                                    "key": "atualizado_desde",
                                    "value": "2026-09-01T00%3A00%3A00-03%3A00",
                                    "description": "S\u00f3 registros alterados a partir desta data. Use ISO-8601 com fuso.",
                                    "disabled": false
                                },
                                {
                                    "key": "page",
                                    "value": "1",
                                    "description": "P\u00e1gina.",
                                    "disabled": false
                                },
                                {
                                    "key": "per_page",
                                    "value": "50",
                                    "description": "Itens por p\u00e1gina (1 a 200).",
                                    "disabled": false
                                }
                            ],
                            "raw": "{{baseUrl}}\/api\/v1\/integracao\/funcionarios?situacao=Ativo&cargo_id=186960&cliente_id=543815&atualizado_desde=2026-09-01T00%3A00%3A00-03%3A00&page=1&per_page=50"
                        },
                        "method": "GET",
                        "header": [
                            {
                                "key": "Content-Type",
                                "value": "application\/json"
                            },
                            {
                                "key": "Accept",
                                "value": "application\/json"
                            }
                        ],
                        "body": null,
                        "description": "Retorna os funcion\u00e1rios da empresa do token, ordenados por\n`atualizado_em` crescente \u2014 a ordem que torna seguro paginar at\u00e9 o fim e\nusar o \u00faltimo valor como cursor da pr\u00f3xima sincroniza\u00e7\u00e3o."
                    },
                    "response": [
                        {
                            "header": [],
                            "code": 200,
                            "body": "{\n  \"data\": [{\n    \"id\": 23638,\n    \"nome\": \"MARIA DA SILVA\",\n    \"matricula\": \"000591\",\n    \"cpf\": \"12345678909\",\n    \"email\": null,\n    \"telefone\": null,\n    \"situacao\": \"Ativo\",\n    \"situacao_fardamento\": \"Em Dia\",\n    \"data_admissao\": \"2024-02-16\",\n    \"ultima_retirada\": \"2026-03-10\",\n    \"proxima_renovacao\": \"2026-09-10\",\n    \"periodicidade_renovacao_dias\": 180,\n    \"cargo\": {\"id\": 186960, \"nome\": \"ASSISTENTE ADMINISTRATIVO\"},\n    \"cliente\": {\"id\": 543815, \"nome\": \"CONDOM\u00cdNIO EXEMPLO\"},\n    \"posto\": {\"id\": 851430, \"nome\": \"CONDOM\u00cdNIO EXEMPLO - ADMINISTRATIVO\"},\n    \"empresa_id\": 1,\n    \"criado_em\": \"2025-10-23T10:00:28-03:00\",\n    \"atualizado_em\": \"2026-08-17T22:27:56-03:00\"\n  }],\n  \"meta\": {\"page\": 1, \"per_page\": 50, \"total\": 5302, \"last_page\": 107}\n}",
                            "name": "sucesso"
                        },
                        {
                            "header": [],
                            "code": 422,
                            "body": "{\"error\": \"valor_invalido\", \"message\": \"'Ferias' n\u00e3o \u00e9 um valor v\u00e1lido para situacao. Aceito: Ativo, Desligado.\"}",
                            "name": "filtro inv\u00e1lido"
                        }
                    ]
                },
                {
                    "name": "Obter um funcion\u00e1rio",
                    "request": {
                        "url": {
                            "host": "{{baseUrl}}",
                            "path": "api\/v1\/integracao\/funcionarios\/:funcionario",
                            "query": [],
                            "raw": "{{baseUrl}}\/api\/v1\/integracao\/funcionarios\/:funcionario",
                            "variable": [
                                {
                                    "id": "funcionario",
                                    "key": "funcionario",
                                    "value": "23638",
                                    "description": "ID do funcion\u00e1rio."
                                }
                            ]
                        },
                        "method": "GET",
                        "header": [
                            {
                                "key": "Content-Type",
                                "value": "application\/json"
                            },
                            {
                                "key": "Accept",
                                "value": "application\/json"
                            }
                        ],
                        "body": null,
                        "description": ""
                    },
                    "response": [
                        {
                            "header": [
                                {
                                    "key": "cache-control",
                                    "value": "no-cache, private"
                                },
                                {
                                    "key": "content-type",
                                    "value": "application\/json"
                                },
                                {
                                    "key": "vary",
                                    "value": "Origin"
                                }
                            ],
                            "code": 401,
                            "body": "{\"error\":\"nao_autenticado\",\"message\":\"Token ausente, inv\\u00e1lido ou expirado. Envie Authorization: Bearer <token>.\"}",
                            "name": ""
                        },
                        {
                            "header": [],
                            "code": 404,
                            "body": "{\"error\": \"nao_encontrado\", \"message\": \"Funcion\u00e1rio n\u00e3o encontrado.\"}",
                            "name": "n\u00e3o encontrado ou de outra empresa"
                        }
                    ]
                }
            ]
        },
        {
            "name": "Itens e estoque",
            "description": "",
            "item": [
                {
                    "name": "Listar itens",
                    "request": {
                        "url": {
                            "host": "{{baseUrl}}",
                            "path": "api\/v1\/integracao\/itens",
                            "query": [
                                {
                                    "key": "codigo",
                                    "value": "000020",
                                    "description": "Filtra pelo c\u00f3digo exato do item.",
                                    "disabled": false
                                },
                                {
                                    "key": "categoria",
                                    "value": "Camisas",
                                    "description": "Filtra pela categoria.",
                                    "disabled": false
                                },
                                {
                                    "key": "ativo",
                                    "value": "1",
                                    "description": "S\u00f3 itens ativos (`true`) ou inativos (`false`).",
                                    "disabled": false
                                },
                                {
                                    "key": "abaixo_do_minimo",
                                    "value": "1",
                                    "description": "S\u00f3 itens com alguma grade no m\u00ednimo ou abaixo.",
                                    "disabled": false
                                },
                                {
                                    "key": "atualizado_desde",
                                    "value": "2026-09-01T00%3A00%3A00-03%3A00",
                                    "description": "S\u00f3 registros alterados a partir desta data.",
                                    "disabled": false
                                },
                                {
                                    "key": "page",
                                    "value": "1",
                                    "description": "P\u00e1gina.",
                                    "disabled": false
                                },
                                {
                                    "key": "per_page",
                                    "value": "50",
                                    "description": "Itens por p\u00e1gina (1 a 200).",
                                    "disabled": false
                                }
                            ],
                            "raw": "{{baseUrl}}\/api\/v1\/integracao\/itens?codigo=000020&categoria=Camisas&ativo=1&abaixo_do_minimo=1&atualizado_desde=2026-09-01T00%3A00%3A00-03%3A00&page=1&per_page=50"
                        },
                        "method": "GET",
                        "header": [
                            {
                                "key": "Content-Type",
                                "value": "application\/json"
                            },
                            {
                                "key": "Accept",
                                "value": "application\/json"
                            }
                        ],
                        "body": null,
                        "description": "O campo `estoque.novos` j\u00e1 vem calculado: para item com grade \u00e9 a soma\ndas grades ATIVAS, n\u00e3o a coluna `itens.estoque` (que fica zerada nesse\ncaso por heran\u00e7a do legado)."
                    },
                    "response": [
                        {
                            "header": [],
                            "code": 200,
                            "body": "{\n  \"data\": [{\n    \"id\": 34,\n    \"codigo\": \"000020\",\n    \"nome\": \"CAL\u00c7A SOCIAL MASCULINA\",\n    \"categoria\": \"Cal\u00e7as\",\n    \"ativo\": true,\n    \"usar_grade\": true,\n    \"estoque\": {\"novos\": 47, \"higienizados\": 3, \"minimo\": 20},\n    \"valor\": {\"novo\": 53, \"higienizado\": 21.2},\n    \"fornecedor\": {\"id\": 5, \"nome\": \"CONFEC\u00c7\u00d5ES EXEMPLO\"},\n    \"estoque_por_grade\": [\n      {\"grade_id\": 155, \"tamanho\": \"42\", \"cor\": null, \"marca\": null,\n       \"novos\": 12, \"higienizados\": 1, \"minimo\": 5,\n       \"abaixo_do_minimo\": false, \"valor\": 53}\n    ],\n    \"empresa_id\": 1,\n    \"criado_em\": \"2025-10-23T10:00:28-03:00\",\n    \"atualizado_em\": \"2026-08-17T22:27:56-03:00\"\n  }],\n  \"meta\": {\"page\": 1, \"per_page\": 50, \"total\": 128, \"last_page\": 3}\n}",
                            "name": "sucesso"
                        }
                    ]
                },
                {
                    "name": "Obter um item",
                    "request": {
                        "url": {
                            "host": "{{baseUrl}}",
                            "path": "api\/v1\/integracao\/itens\/:item",
                            "query": [],
                            "raw": "{{baseUrl}}\/api\/v1\/integracao\/itens\/:item",
                            "variable": [
                                {
                                    "id": "item",
                                    "key": "item",
                                    "value": "34",
                                    "description": "ID do item."
                                }
                            ]
                        },
                        "method": "GET",
                        "header": [
                            {
                                "key": "Content-Type",
                                "value": "application\/json"
                            },
                            {
                                "key": "Accept",
                                "value": "application\/json"
                            }
                        ],
                        "body": null,
                        "description": ""
                    },
                    "response": [
                        {
                            "header": [
                                {
                                    "key": "cache-control",
                                    "value": "no-cache, private"
                                },
                                {
                                    "key": "content-type",
                                    "value": "application\/json"
                                },
                                {
                                    "key": "vary",
                                    "value": "Origin"
                                }
                            ],
                            "code": 401,
                            "body": "{\"error\":\"nao_autenticado\",\"message\":\"Token ausente, inv\\u00e1lido ou expirado. Envie Authorization: Bearer <token>.\"}",
                            "name": ""
                        },
                        {
                            "header": [],
                            "code": 404,
                            "body": "{\"error\": \"nao_encontrado\", \"message\": \"Item n\u00e3o encontrado.\"}",
                            "name": "n\u00e3o encontrado ou de outra empresa"
                        }
                    ]
                }
            ]
        },
        {
            "name": "Movimentos de estoque",
            "description": "",
            "item": [
                {
                    "name": "Listar movimentos de estoque",
                    "request": {
                        "url": {
                            "host": "{{baseUrl}}",
                            "path": "api\/v1\/integracao\/movimentos-estoque",
                            "query": [
                                {
                                    "key": "desde_id",
                                    "value": "32020",
                                    "description": "S\u00f3 movimentos com id MAIOR que este. \u00c9 o cursor de sincroniza\u00e7\u00e3o.",
                                    "disabled": false
                                },
                                {
                                    "key": "item_id",
                                    "value": "34",
                                    "description": "Filtra por item.",
                                    "disabled": false
                                },
                                {
                                    "key": "grade_id",
                                    "value": "155",
                                    "description": "Filtra por varia\u00e7\u00e3o (tamanho\/cor\/marca).",
                                    "disabled": false
                                },
                                {
                                    "key": "tipo",
                                    "value": "ajuste",
                                    "description": "Tipo do movimento. Aceita entrega, ajuste, entrada, reserva_pedido, cancelamento_reserva_pedido, saida_cliente, cancelamento_entrega, cancelamento_saida_cliente, retorno_saida_cliente, saldo_inicial.",
                                    "disabled": false
                                },
                                {
                                    "key": "tipo_estoque",
                                    "value": "novo",
                                    "description": "`novo` ou `higienizado` \u2014 s\u00e3o saldos separados do mesmo item.",
                                    "disabled": false
                                },
                                {
                                    "key": "de",
                                    "value": "2026-08-01",
                                    "description": "Data inicial do movimento.",
                                    "disabled": false
                                },
                                {
                                    "key": "ate",
                                    "value": "2026-08-31",
                                    "description": "Data final, inclusiva.",
                                    "disabled": false
                                },
                                {
                                    "key": "page",
                                    "value": "1",
                                    "description": "P\u00e1gina.",
                                    "disabled": false
                                },
                                {
                                    "key": "per_page",
                                    "value": "200",
                                    "description": "Itens por p\u00e1gina (1 a 200).",
                                    "disabled": false
                                }
                            ],
                            "raw": "{{baseUrl}}\/api\/v1\/integracao\/movimentos-estoque?desde_id=32020&item_id=34&grade_id=155&tipo=ajuste&tipo_estoque=novo&de=2026-08-01&ate=2026-08-31&page=1&per_page=200"
                        },
                        "method": "GET",
                        "header": [
                            {
                                "key": "Content-Type",
                                "value": "application\/json"
                            },
                            {
                                "key": "Accept",
                                "value": "application\/json"
                            }
                        ],
                        "body": null,
                        "description": "O raz\u00e3o completo: toda altera\u00e7\u00e3o de saldo, com o valor antes e depois.\n\u00c9 o que responde \"por que o saldo mudou\" \u2014 entrega \u00e9 menos da metade dos\nmovimentos, e um relat\u00f3rio de consumo que s\u00f3 some entregas nunca fecha\ncom o saldo de `\/itens`.\n\n`quantidade` \u00e9 o delta: negativo saiu, positivo entrou. Somar o delta num\nper\u00edodo d\u00e1 a varia\u00e7\u00e3o l\u00edquida daquele per\u00edodo.\n\n**Sincroniza\u00e7\u00e3o \u00e9 por `desde_id`, n\u00e3o por `atualizado_desde`.** A tabela\n\u00e9 append-only (trigger no banco bloqueia UPDATE e DELETE), ent\u00e3o linha\nque entrou nunca muda nem some. Guarde o maior `id` que voc\u00ea importou e\nmande de volta: o cursor \u00e9 exato, sem risco de pular ou repetir registro\ncomo acontece em pagina\u00e7\u00e3o por offset sobre dado que muda.\n\n## Duas coisas que parecem erro e n\u00e3o s\u00e3o\n\n**Movimentos datados de 1969\/1970.** S\u00e3o os `saldo_inicial` vindos da\nmigra\u00e7\u00e3o do sistema anterior, gravados sem data de origem e por isso na\n\u00e9poca Unix. Filtrar por `de`\/`ate` descarta esses registros \u2014 e sem eles\na reconstru\u00e7\u00e3o de saldo n\u00e3o fecha, porque s\u00e3o justamente o ponto de\npartida. Para reconstruir saldo, use `desde_id` a partir do zero, n\u00e3o\njanela de data.\n\n**`saldo.depois` negativo.** Acontece: o sistema permite sa\u00edda sem saldo\nem alguns fluxos, e a migra\u00e7\u00e3o trouxe posi\u00e7\u00f5es negativas. N\u00e3o trate\nnegativo como dado corrompido nem force piso em zero \u2014 o n\u00famero \u00e9 o que\no estoque de fato registrava naquele instante."
                    },
                    "response": [
                        {
                            "header": [],
                            "code": 200,
                            "body": "{\n  \"data\": [{\n    \"id\": 31998,\n    \"data\": \"2026-08-27T10:14:02-03:00\",\n    \"tipo\": \"entrega\",\n    \"tipo_estoque\": \"novo\",\n    \"item\": {\"id\": 34, \"nome\": \"CAL\u00c7A SOCIAL MASCULINA\", \"codigo\": \"000020\"},\n    \"grade\": {\"id\": 155, \"tamanho\": \"42\", \"cor\": null, \"marca\": \"PADR\u00c3O\"},\n    \"quantidade\": -2,\n    \"saldo\": {\"antes\": 12, \"depois\": 10},\n    \"origem\": {\"tabela\": \"entrega_itens\", \"id\": 140},\n    \"observacao\": null,\n    \"empresa_id\": 1\n  }],\n  \"meta\": {\"page\": 1, \"per_page\": 200, \"total\": 32020, \"last_page\": 161}\n}",
                            "name": "sucesso"
                        },
                        {
                            "header": [],
                            "code": 422,
                            "body": "{\"error\": \"valor_invalido\", \"message\": \"'devolucao' n\u00e3o \u00e9 um valor v\u00e1lido para tipo. Aceito: entrega, ajuste, entrada, reserva_pedido, cancelamento_reserva_pedido, saida_cliente, cancelamento_entrega, cancelamento_saida_cliente, retorno_saida_cliente, saldo_inicial.\"}",
                            "name": "tipo inv\u00e1lido"
                        }
                    ]
                }
            ]
        },
        {
            "name": "Pedidos a fornecedor",
            "description": "",
            "item": [
                {
                    "name": "Listar pedidos a fornecedor",
                    "request": {
                        "url": {
                            "host": "{{baseUrl}}",
                            "path": "api\/v1\/integracao\/pedidos-fornecedor",
                            "query": [
                                {
                                    "key": "status",
                                    "value": "recebido_sistema",
                                    "description": "Status do pedido. Aceita pendente, aguardando_aprovacao_interna, recebido_fornecedor, separado, entregue, parcialmente_recebido, recebido_sistema, cancelado.",
                                    "disabled": false
                                },
                                {
                                    "key": "tipo",
                                    "value": "Pedido+para+reposi%C3%A7%C3%A3o+de+estoque",
                                    "description": "Categoria da compra, com match exato. \u00c9 r\u00f3tulo de texto livre, n\u00e3o lista fechada \u2014 liste os valores existentes antes de filtrar. Para separar pedidos complementares use o campo `complementar`, n\u00e3o este.",
                                    "disabled": false
                                },
                                {
                                    "key": "fornecedor_id",
                                    "value": "5",
                                    "description": "Filtra por fornecedor.",
                                    "disabled": false
                                },
                                {
                                    "key": "de",
                                    "value": "2026-08-01",
                                    "description": "Data inicial (dia do pedido).",
                                    "disabled": false
                                },
                                {
                                    "key": "ate",
                                    "value": "2026-08-31",
                                    "description": "Data final, inclusiva.",
                                    "disabled": false
                                },
                                {
                                    "key": "atualizado_desde",
                                    "value": "2026-09-01T00%3A00%3A00-03%3A00",
                                    "description": "S\u00f3 registros alterados a partir desta data.",
                                    "disabled": false
                                },
                                {
                                    "key": "page",
                                    "value": "1",
                                    "description": "P\u00e1gina.",
                                    "disabled": false
                                },
                                {
                                    "key": "per_page",
                                    "value": "50",
                                    "description": "Itens por p\u00e1gina (1 a 200).",
                                    "disabled": false
                                }
                            ],
                            "raw": "{{baseUrl}}\/api\/v1\/integracao\/pedidos-fornecedor?status=recebido_sistema&tipo=Pedido+para+reposi%C3%A7%C3%A3o+de+estoque&fornecedor_id=5&de=2026-08-01&ate=2026-08-31&atualizado_desde=2026-09-01T00%3A00%3A00-03%3A00&page=1&per_page=50"
                        },
                        "method": "GET",
                        "header": [
                            {
                                "key": "Content-Type",
                                "value": "application\/json"
                            },
                            {
                                "key": "Accept",
                                "value": "application\/json"
                            }
                        ],
                        "body": null,
                        "description": "\u00c9 o outro lado de `pedidos-internos`: ali o funcion\u00e1rio pede, aqui a\nempresa compra para repor. N\u00e3o some os dois ao medir volume \u2014 um consome\nestoque, o outro o rep\u00f5e.\n\nCada item traz tr\u00eas quantidades (`sugerida`, `confirmada`, `recebida`)\nporque um pedido raramente chega inteiro de uma vez. `confirmada` vem\n`null` enquanto o fornecedor n\u00e3o respondeu, o que \u00e9 diferente de zero.\n\n`status` \u00e9 padronizado. `tipo` \u00e9 texto livre \u2014 trate como r\u00f3tulo.\n\nN\u00e3o agrupe por `tipo` esperando s\u00f3 categorias de compra: a coluna tamb\u00e9m\ncarrega o valor `complemento`, que marca pedido-filho criado pra cobrir\na falta de outro. Use o campo `complementar` para essa distin\u00e7\u00e3o; ele\nexiste justamente pra separar os dois eixos."
                    },
                    "response": [
                        {
                            "header": [],
                            "code": 200,
                            "body": "{\n  \"data\": [{\n    \"id\": 88,\n    \"status\": \"recebido_sistema\",\n    \"tipo\": \"Pedido para reposi\u00e7\u00e3o de estoque\",\n    \"complementar\": false,\n    \"valor_total\": 4240,\n    \"fornecedor\": {\"id\": 5, \"nome\": \"CONFEC\u00c7\u00d5ES EXEMPLO\", \"cnpj\": \"12345678000199\"},\n    \"datas\": {\n      \"pedido\": \"2026-08-01\",\n      \"prevista_entrega\": \"2026-08-20\",\n      \"aprovacao_interna\": \"2026-08-01T14:00:00-03:00\",\n      \"recebimento_fornecedor\": \"2026-08-02T09:00:00-03:00\",\n      \"separacao\": null,\n      \"entrega\": \"2026-08-19T10:00:00-03:00\",\n      \"recebimento_sistema\": \"2026-08-19T16:30:00-03:00\",\n      \"cancelamento\": null\n    },\n    \"aprovado_internamente\": true,\n    \"cancelado\": false,\n    \"motivo_cancelamento\": null,\n    \"recebido_com_saldo\": false,\n    \"pagamento\": {\"forma\": \"Boleto 30 dias\", \"vencimento\": \"2026-09-18\"},\n    \"observacoes\": null,\n    \"itens\": [{\n      \"id\": 512,\n      \"item\": {\"id\": 34, \"nome\": \"CAL\u00c7A SOCIAL MASCULINA\", \"codigo\": \"000020\"},\n      \"grade\": {\"id\": 155, \"tamanho\": \"42\", \"cor\": null, \"marca\": \"PADR\u00c3O\"},\n      \"quantidade\": {\"sugerida\": 80, \"confirmada\": 80, \"recebida\": 80, \"pendente\": 0},\n      \"valor\": {\"original\": 53, \"fornecedor\": 53}\n    }],\n    \"empresa_id\": 1,\n    \"criado_em\": \"2026-08-01T13:40:00-03:00\",\n    \"atualizado_em\": \"2026-08-19T16:30:00-03:00\"\n  }],\n  \"meta\": {\"page\": 1, \"per_page\": 50, \"total\": 88, \"last_page\": 2}\n}",
                            "name": "sucesso"
                        }
                    ]
                },
                {
                    "name": "Obter um pedido a fornecedor",
                    "request": {
                        "url": {
                            "host": "{{baseUrl}}",
                            "path": "api\/v1\/integracao\/pedidos-fornecedor\/:pedido",
                            "query": [],
                            "raw": "{{baseUrl}}\/api\/v1\/integracao\/pedidos-fornecedor\/:pedido",
                            "variable": [
                                {
                                    "id": "pedido",
                                    "key": "pedido",
                                    "value": "88",
                                    "description": "ID do pedido."
                                }
                            ]
                        },
                        "method": "GET",
                        "header": [
                            {
                                "key": "Content-Type",
                                "value": "application\/json"
                            },
                            {
                                "key": "Accept",
                                "value": "application\/json"
                            }
                        ],
                        "body": null,
                        "description": ""
                    },
                    "response": [
                        {
                            "header": [
                                {
                                    "key": "cache-control",
                                    "value": "no-cache, private"
                                },
                                {
                                    "key": "content-type",
                                    "value": "application\/json"
                                },
                                {
                                    "key": "vary",
                                    "value": "Origin"
                                }
                            ],
                            "code": 401,
                            "body": "{\"error\":\"nao_autenticado\",\"message\":\"Token ausente, inv\\u00e1lido ou expirado. Envie Authorization: Bearer <token>.\"}",
                            "name": ""
                        },
                        {
                            "header": [],
                            "code": 404,
                            "body": "{\"error\": \"nao_encontrado\", \"message\": \"Pedido n\u00e3o encontrado.\"}",
                            "name": "n\u00e3o encontrado ou de outra empresa"
                        }
                    ]
                }
            ]
        },
        {
            "name": "Pedidos internos",
            "description": "",
            "item": [
                {
                    "name": "Listar pedidos internos",
                    "request": {
                        "url": {
                            "host": "{{baseUrl}}",
                            "path": "api\/v1\/integracao\/pedidos-internos",
                            "query": [
                                {
                                    "key": "status",
                                    "value": "Conclu%C3%ADda",
                                    "description": "Status do pedido. Aceita Pendente, Aprovada, Rejeitada, Cancelado, Conclu\u00edda.",
                                    "disabled": false
                                },
                                {
                                    "key": "funcionario_id",
                                    "value": "25826",
                                    "description": "Filtra por funcion\u00e1rio.",
                                    "disabled": false
                                },
                                {
                                    "key": "cliente_id",
                                    "value": "543814",
                                    "description": "Filtra pela unidade\/contratante.",
                                    "disabled": false
                                },
                                {
                                    "key": "de",
                                    "value": "2026-08-01",
                                    "description": "Data inicial (dia da solicita\u00e7\u00e3o).",
                                    "disabled": false
                                },
                                {
                                    "key": "ate",
                                    "value": "2026-08-31",
                                    "description": "Data final, inclusiva.",
                                    "disabled": false
                                },
                                {
                                    "key": "atualizado_desde",
                                    "value": "2026-09-01T00%3A00%3A00-03%3A00",
                                    "description": "S\u00f3 registros alterados a partir desta data.",
                                    "disabled": false
                                },
                                {
                                    "key": "page",
                                    "value": "1",
                                    "description": "P\u00e1gina.",
                                    "disabled": false
                                },
                                {
                                    "key": "per_page",
                                    "value": "50",
                                    "description": "Itens por p\u00e1gina (1 a 200).",
                                    "disabled": false
                                }
                            ],
                            "raw": "{{baseUrl}}\/api\/v1\/integracao\/pedidos-internos?status=Conclu%C3%ADda&funcionario_id=25826&cliente_id=543814&de=2026-08-01&ate=2026-08-31&atualizado_desde=2026-09-01T00%3A00%3A00-03%3A00&page=1&per_page=50"
                        },
                        "method": "GET",
                        "header": [
                            {
                                "key": "Content-Type",
                                "value": "application\/json"
                            },
                            {
                                "key": "Accept",
                                "value": "application\/json"
                            }
                        ],
                        "body": null,
                        "description": "`funcionario` (para quem \u00e9) e `solicitante` (quem pediu) s\u00e3o pessoas\ndiferentes na maioria dos pedidos \u2014 agregar por solicitante quando a\npergunta \u00e9 \"quanto cada colaborador consumiu\" produz o n\u00famero errado."
                    },
                    "response": [
                        {
                            "header": [],
                            "code": 200,
                            "body": "{\n  \"data\": [{\n    \"id\": 412,\n    \"status\": \"Conclu\u00edda\",\n    \"tipo\": \"Renova\u00e7\u00e3o\",\n    \"parcial\": false,\n    \"prazo_curto\": false,\n    \"data_solicitacao\": \"2026-08-03\",\n    \"data_aprovacao\": \"2026-08-04T09:12:00-03:00\",\n    \"data_pronto_retirada\": \"2026-08-06T14:00:00-03:00\",\n    \"data_cancelamento\": null,\n    \"justificativa_cancelamento\": null,\n    \"funcionario\": {\"id\": 25826, \"nome\": \"JO\u00c3O SANTOS\", \"matricula\": \"006607\", \"cpf\": \"12345678909\"},\n    \"solicitante\": {\"id\": \"0b14efad-\u2026\", \"nome\": \"MARIA SUPERVISORA\"},\n    \"cliente\": {\"id\": 543814, \"nome\": \"CONDOM\u00cdNIO EXEMPLO\"},\n    \"motivo\": {\"id\": 3, \"nome\": \"Desgaste\"},\n    \"observacoes_motivo\": null,\n    \"entrega_id\": 73,\n    \"itens\": [{\n      \"id\": 901,\n      \"item\": {\"id\": 34, \"nome\": \"CAL\u00c7A SOCIAL MASCULINA\", \"codigo\": \"000020\"},\n      \"grade\": {\"id\": 155, \"tamanho\": \"42\", \"cor\": null, \"marca\": null},\n      \"quantidade\": 2, \"tipo_estoque\": \"novo\",\n      \"valor_unitario\": 53, \"valor_total\": 106\n    }],\n    \"empresa_id\": 1,\n    \"criado_em\": \"2026-08-03T08:40:00-03:00\",\n    \"atualizado_em\": \"2026-08-06T14:00:00-03:00\"\n  }],\n  \"meta\": {\"page\": 1, \"per_page\": 50, \"total\": 412, \"last_page\": 9}\n}",
                            "name": "sucesso"
                        }
                    ]
                },
                {
                    "name": "Obter um pedido interno",
                    "request": {
                        "url": {
                            "host": "{{baseUrl}}",
                            "path": "api\/v1\/integracao\/pedidos-internos\/:pedido",
                            "query": [],
                            "raw": "{{baseUrl}}\/api\/v1\/integracao\/pedidos-internos\/:pedido",
                            "variable": [
                                {
                                    "id": "pedido",
                                    "key": "pedido",
                                    "value": "412",
                                    "description": "ID do pedido."
                                }
                            ]
                        },
                        "method": "GET",
                        "header": [
                            {
                                "key": "Content-Type",
                                "value": "application\/json"
                            },
                            {
                                "key": "Accept",
                                "value": "application\/json"
                            }
                        ],
                        "body": null,
                        "description": ""
                    },
                    "response": [
                        {
                            "header": [
                                {
                                    "key": "cache-control",
                                    "value": "no-cache, private"
                                },
                                {
                                    "key": "content-type",
                                    "value": "application\/json"
                                },
                                {
                                    "key": "vary",
                                    "value": "Origin"
                                }
                            ],
                            "code": 401,
                            "body": "{\"error\":\"nao_autenticado\",\"message\":\"Token ausente, inv\\u00e1lido ou expirado. Envie Authorization: Bearer <token>.\"}",
                            "name": ""
                        },
                        {
                            "header": [],
                            "code": 404,
                            "body": "{\"error\": \"nao_encontrado\", \"message\": \"Pedido n\u00e3o encontrado.\"}",
                            "name": "n\u00e3o encontrado ou de outra empresa"
                        }
                    ]
                }
            ]
        },
        {
            "name": "Sa\u00eddas para cliente",
            "description": "",
            "item": [
                {
                    "name": "Listar sa\u00eddas para cliente",
                    "request": {
                        "url": {
                            "host": "{{baseUrl}}",
                            "path": "api\/v1\/integracao\/saidas-clientes",
                            "query": [
                                {
                                    "key": "status",
                                    "value": "concluida",
                                    "description": "Situa\u00e7\u00e3o. Aceita pendente, em_distribuicao, concluida, cancelada.",
                                    "disabled": false
                                },
                                {
                                    "key": "tipo",
                                    "value": "cliente",
                                    "description": "`cliente` ou `interno`.",
                                    "disabled": false
                                },
                                {
                                    "key": "cliente_id",
                                    "value": "543814",
                                    "description": "Filtra pela unidade\/contratante.",
                                    "disabled": false
                                },
                                {
                                    "key": "de",
                                    "value": "2026-08-01",
                                    "description": "Data inicial.",
                                    "disabled": false
                                },
                                {
                                    "key": "ate",
                                    "value": "2026-08-31",
                                    "description": "Data final, inclusiva.",
                                    "disabled": false
                                },
                                {
                                    "key": "atualizado_desde",
                                    "value": "2026-09-01T00%3A00%3A00-03%3A00",
                                    "description": "S\u00f3 registros alterados a partir desta data.",
                                    "disabled": false
                                },
                                {
                                    "key": "page",
                                    "value": "1",
                                    "description": "P\u00e1gina.",
                                    "disabled": false
                                },
                                {
                                    "key": "per_page",
                                    "value": "50",
                                    "description": "Itens por p\u00e1gina (1 a 200).",
                                    "disabled": false
                                }
                            ],
                            "raw": "{{baseUrl}}\/api\/v1\/integracao\/saidas-clientes?status=concluida&tipo=cliente&cliente_id=543814&de=2026-08-01&ate=2026-08-31&atualizado_desde=2026-09-01T00%3A00%3A00-03%3A00&page=1&per_page=50"
                        },
                        "method": "GET",
                        "header": [
                            {
                                "key": "Content-Type",
                                "value": "application\/json"
                            },
                            {
                                "key": "Accept",
                                "value": "application\/json"
                            }
                        ],
                        "body": null,
                        "description": "Diferente de entrega, que \u00e9 individual: aqui o material sai para um\nposto inteiro e o supervisor distribui l\u00e1.\n\nDuas listas que precisam ser lidas juntas: `funcionarios` (para quem o\nlote foi previsto, e se virou entrega) e `retornados` (o que voltou como\nsobra ou reclassifica\u00e7\u00e3o). \"Saiu 40, voltou 6\" s\u00f3 \u00e9 respond\u00edvel com as\nduas \u2014 a sa\u00edda sozinha conta apenas o que foi.\n\nEm `funcionarios[].entrega_id`: preenchido significa que a distribui\u00e7\u00e3o\nvirou entrega de verdade. \u00c9 o que separa previsto de recebido, e o\nv\u00ednculo com `\/entregas`."
                    },
                    "response": [
                        {
                            "header": [],
                            "code": 200,
                            "body": "{\n  \"data\": [{\n    \"id\": 54,\n    \"data\": \"2026-08-12\",\n    \"status\": \"concluida\",\n    \"tipo\": \"cliente\",\n    \"destino\": \"PORTARIA PRINCIPAL\",\n    \"cliente\": {\"id\": 543814, \"nome\": \"CONDOM\u00cdNIO EXEMPLO\"},\n    \"cancelada\": false,\n    \"motivo_cancelamento\": null,\n    \"concluida_em\": \"2026-08-14T17:20:00-03:00\",\n    \"cancelada_em\": null,\n    \"observacoes\": null,\n    \"funcionarios\": [{\n      \"id\": 220,\n      \"funcionario\": {\"id\": 25826, \"nome\": \"JO\u00c3O SANTOS\", \"matricula\": \"006607\"},\n      \"status\": \"entregue\",\n      \"entrega_id\": 73,\n      \"observacao\": null,\n      \"itens\": [{\n        \"id\": 990,\n        \"item\": {\"id\": 34, \"nome\": \"CAL\u00c7A SOCIAL MASCULINA\", \"codigo\": \"000020\"},\n        \"grade\": {\"id\": 155, \"tamanho\": \"42\", \"cor\": null, \"marca\": \"PADR\u00c3O\"},\n        \"quantidade\": 2,\n        \"tipo_estoque\": \"novo\",\n        \"divergente_kit\": false\n      }]\n    }],\n    \"retornados\": [{\n      \"id\": 41,\n      \"item\": {\"id\": 34, \"nome\": \"CAL\u00c7A SOCIAL MASCULINA\", \"codigo\": \"000020\"},\n      \"grade\": {\"id\": 155, \"tamanho\": \"42\", \"cor\": null, \"marca\": \"PADR\u00c3O\"},\n      \"quantidade\": 1,\n      \"tipo_estoque_origem\": \"novo\",\n      \"destino\": \"estoque\",\n      \"observacao\": null\n    }],\n    \"empresa_id\": 1,\n    \"criado_em\": \"2026-08-12T09:00:00-03:00\",\n    \"atualizado_em\": \"2026-08-14T17:20:00-03:00\"\n  }],\n  \"meta\": {\"page\": 1, \"per_page\": 50, \"total\": 55, \"last_page\": 2}\n}",
                            "name": "sucesso"
                        }
                    ]
                },
                {
                    "name": "Obter uma sa\u00edda para cliente",
                    "request": {
                        "url": {
                            "host": "{{baseUrl}}",
                            "path": "api\/v1\/integracao\/saidas-clientes\/:saida",
                            "query": [],
                            "raw": "{{baseUrl}}\/api\/v1\/integracao\/saidas-clientes\/:saida",
                            "variable": [
                                {
                                    "id": "saida",
                                    "key": "saida",
                                    "value": "54",
                                    "description": "ID da sa\u00edda."
                                }
                            ]
                        },
                        "method": "GET",
                        "header": [
                            {
                                "key": "Content-Type",
                                "value": "application\/json"
                            },
                            {
                                "key": "Accept",
                                "value": "application\/json"
                            }
                        ],
                        "body": null,
                        "description": ""
                    },
                    "response": [
                        {
                            "header": [
                                {
                                    "key": "cache-control",
                                    "value": "no-cache, private"
                                },
                                {
                                    "key": "content-type",
                                    "value": "application\/json"
                                },
                                {
                                    "key": "vary",
                                    "value": "Origin"
                                }
                            ],
                            "code": 401,
                            "body": "{\"error\":\"nao_autenticado\",\"message\":\"Token ausente, inv\\u00e1lido ou expirado. Envie Authorization: Bearer <token>.\"}",
                            "name": ""
                        },
                        {
                            "header": [],
                            "code": 404,
                            "body": "{\"error\": \"nao_encontrado\", \"message\": \"Sa\u00edda n\u00e3o encontrada.\"}",
                            "name": "n\u00e3o encontrada ou de outra empresa"
                        }
                    ]
                }
            ]
        }
    ],
    "auth": {
        "type": "bearer",
        "bearer": [
            {
                "key": "key",
                "type": "string"
            }
        ]
    }
}