{"openapi":"3.1.0","info":{"title":"Lojas Angatu — API de Entregas","version":"1.0.0","description":"Recebimento autenticado e idempotente de empresas e programações de saída da GiuSoft.","contact":{"name":"Lojas Angatu"}},"servers":[{"url":"https://api.lojasangatu.com.br","description":"Produção"}],"tags":[{"name":"Autenticação"},{"name":"Programações"}],"paths":{"/api/integrations/v1/auth/token":{"post":{"operationId":"createIntegrationToken","tags":["Autenticação"],"summary":"Gerar token de integração","description":"Autentica uma credencial exclusiva de integração. O token expira após uma hora.","security":[],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["usuario","senha"],"properties":{"usuario":{"type":"string","minLength":3,"maxLength":80,"example":"giusoft-wms"},"senha":{"type":"string","minLength":16,"maxLength":128,"format":"password","writeOnly":true}}}}}},"responses":{"200":{"description":"Token emitido","headers":{"Cache-Control":{"schema":{"const":"no-store"}}},"content":{"application/json":{"schema":{"type":"object","required":["access_token","token_type","expires_in","scope"],"properties":{"access_token":{"type":"string","writeOnly":true},"token_type":{"const":"Bearer"},"expires_in":{"const":3600},"scope":{"const":"delivery:write"}}}}}},"401":{"$ref":"#/components/responses/Error"},"415":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}},"/api/integrations/v1/delivery-programs":{"post":{"operationId":"ingestDeliveryPrograms","tags":["Programações"],"summary":"Enviar empresa e programações de saída","description":"Aceita até 100 programações, 5.000 linhas de itens e 5 MB por operação.","security":[{"bearerAuth":[]}],"parameters":[{"name":"Idempotency-Key","in":"header","required":true,"description":"UUID v4 recomendado. Uma chave só pode repetir exatamente o mesmo conteúdo.","schema":{"type":"string","minLength":16,"maxLength":100},"example":"7a63fdf8-1fd8-43cb-bfea-f424265bc665"}],"requestBody":{"required":true,"content":{"application/json":{"schema":{"type":"object","additionalProperties":false,"required":["empresa","programacoesSaida"],"properties":{"empresa":{"$ref":"#/components/schemas/Empresa"},"programacoesSaida":{"type":"array","minItems":1,"maxItems":100,"items":{"$ref":"#/components/schemas/ProgramacaoComItens"}}}}}}},"responses":{"200":{"description":"Operação persistida ou repetição idempotente","content":{"application/json":{"schema":{"type":"object","required":["accepted","duplicate","company_id","programs_received","items_received","processed_at","request_id"],"properties":{"accepted":{"const":true},"duplicate":{"type":"boolean"},"company_id":{"type":"string"},"programs_received":{"type":"integer","minimum":1},"items_received":{"type":"integer","minimum":0},"processed_at":{"type":"string","format":"date-time"},"request_id":{"type":"string"}}}}}},"400":{"$ref":"#/components/responses/Error"},"401":{"$ref":"#/components/responses/Error"},"409":{"$ref":"#/components/responses/Error"},"413":{"$ref":"#/components/responses/Error"},"415":{"$ref":"#/components/responses/Error"},"429":{"$ref":"#/components/responses/Error"},"503":{"$ref":"#/components/responses/Error"}}}}},"components":{"securitySchemes":{"bearerAuth":{"type":"http","scheme":"bearer","bearerFormat":"JWT"}},"responses":{"Error":{"description":"Erro seguro","headers":{"X-Request-Id":{"schema":{"type":"string"},"description":"Identificador para diagnóstico."}},"content":{"application/json":{"schema":{"type":"object","required":["error"],"properties":{"error":{"type":"string"},"request_id":{"type":"string"}}}}}}},"schemas":{"Empresa":{"type":"object","additionalProperties":false,"required":["id","nome","tipo","cnpj","codigoSistemaExterno","endereco","cep"],"properties":{"id":{"type":"string","pattern":"^[0-9]{1,20}$","example":"5139"},"nome":{"type":"string","minLength":1,"maxLength":255,"example":"CLIENTE EXEMPLO"},"tipo":{"type":"string","enum":["F","J"]},"cnpj":{"type":"string","pattern":"^(?:[0-9]{11}|[0-9]{14})$","description":"CPF ou CNPJ sem pontuação."},"codigoSistemaExterno":{"type":"string","minLength":1,"maxLength":50},"endereco":{"type":"string","minLength":1,"maxLength":500},"complemento":{"type":["string","null"],"maxLength":255},"cep":{"type":"string","pattern":"^[0-9]{8}$"}}},"ProgramacaoComItens":{"type":"object","additionalProperties":false,"required":["programacaoSaida","itens"],"properties":{"programacaoSaida":{"$ref":"#/components/schemas/ProgramacaoSaida"},"itens":{"type":"array","maxItems":2000,"items":{"$ref":"#/components/schemas/ItemProgramacao"}}}},"ProgramacaoSaida":{"type":"object","required":["id"],"properties":{"id":{"type":"string","pattern":"^[0-9]{1,20}$"},"os":{"type":["string","null"],"maxLength":20},"numeroCliente":{"type":["string","null"],"maxLength":40},"reservada":{"oneOf":[{"type":"integer","enum":[0,1]},{"type":"string","enum":["0","1"]}]},"iniciada":{"oneOf":[{"type":"integer","enum":[0,1]},{"type":"string","enum":["0","1"]}]},"separada":{"oneOf":[{"type":"integer","enum":[0,1]},{"type":"string","enum":["0","1"]}]},"conferida":{"oneOf":[{"type":"integer","enum":[0,1]},{"type":"string","enum":["0","1"]}]},"executada":{"oneOf":[{"type":"integer","enum":[0,1]},{"type":"string","enum":["0","1"]}]},"cancelada":{"oneOf":[{"type":"integer","enum":[0,1]},{"type":"string","enum":["0","1"]}]},"dataExecucaoInicio":{"type":["string","null"],"maxLength":32,"example":"2026-08-20 14:30:00"},"dataExecucaoFim":{"type":["string","null"],"maxLength":32,"example":null},"dataCancelamento":{"type":["string","null"],"maxLength":32,"example":null}}},"ItemProgramacao":{"type":"object","properties":{"id":{"type":["string","null"],"maxLength":120},"codigoItem":{"type":["string","null"],"maxLength":255},"codigoBarrasItem":{"type":["string","null"],"maxLength":255},"siglaUnidade":{"type":["string","null"],"maxLength":80},"descricaoUnidade":{"type":["string","null"],"maxLength":120},"numeroSequencia":{"type":["string","null"],"maxLength":80},"quantidadeProgramada":{"oneOf":[{"type":"number","minimum":0},{"type":"string","pattern":"^[0-9]+(?:\\.[0-9]+)?$"}]},"quantidadeReservada":{"oneOf":[{"type":"number","minimum":0},{"type":"string","pattern":"^[0-9]+(?:\\.[0-9]+)?$"}]},"quantidadeSeparada":{"oneOf":[{"type":"number","minimum":0},{"type":"string","pattern":"^[0-9]+(?:\\.[0-9]+)?$"}]},"quantidadeExpedida":{"oneOf":[{"type":"number","minimum":0},{"type":"string","pattern":"^[0-9]+(?:\\.[0-9]+)?$"}]},"lote":{"type":["string","null"],"maxLength":160},"dataValidade":{"type":["string","null"],"maxLength":32},"dataFabricacao":{"type":["string","null"],"maxLength":32},"avariada":{"oneOf":[{"type":"integer","enum":[0,1]},{"type":"string","enum":["0","1"]}]}}}}}}