> ## Documentation Index > Fetch the complete documentation index at: https://documentacao.mgnsystem.com.br/llms.txt > Use this file to discover all available pages before exploring further. # Documentos de Saída > https://[url.projeto]/wms/v1/documentos-saida ## **Visão Geral** A API de Documentos de Saída do WMS foi desenvolvida para receber informações de **sistemas externos** e transformar esses dados em **registros estruturados** dentro do processo de expedição do armazém. Seu objetivo é permitir a integração padronizada de pedidos e notas fiscais de saída, **centralizando no backend** toda a **validação**, **normalização**, **cálculo e persistência das informações**. Com isso, a integração não depende de regras no front-end e garante maior consistência operacional. A integração segue o conceito de **processamento em lote**, permitindo o envio de um ou mais documentos na mesma requisição, com retorno estruturado por item processado. Para documentos de saída, a integração também realiza uma análise inicial de estoque: * para `nfe`, a verificação considera o **produto e o lote exato** * para **pedido**, a verificação considera: * **produto + lote**, quando o lote é informado * ou o **saldo total do produto**, quando o lote não é informado Com base nessa análise, os itens e o documento podem ser classificados conforme disponibilidade **total**, **parcial** ou **indisponível de estoque,** permitindo que o processo operacional já se inicie com uma visão de atendimento. Método HTTP: POST `/v1/documentos-saida` ## Headers | Nome | Valor | | :------------ | :----------------- | | Content-Type | `application/json` | | Authorization | `Bearer ` | ## Campos ### Documento | **Nome** | **Tipo** | **Descrição** | | :------------- | :------- | :--------------------------------------------------- | | `codigo` | string | Código ou Numero | | `tipo` | string | `nfe` ou `pedido` | | `serie` | string | Série do documento | | `chave_acesso` | string | Chave de acesso quando o tipo de documento for `nfe` | | `data_emissao` | string | formato `yyyy-mm-ddd` | | `origem_id` | string | Identificador de origem do sistema externo | ### Emitente | **Nome** | **Tipo** | **Descrição** | | :-------------------- | :------- | :----------------------------------- | | `codigo` | string | codigo interno do erp | | `nome` | string | Nome ou razão social do destinatário | | `documento` | string | CNPJ ou CPF do destinatário | | `tipo_pessoa` | string | `juridica` ou `fisica` | | `endereco.logradouro` | string | Nome da rua / avenida | | `endereco.numero` | string | Número do endereço | | `endereco.bairro` | string | Bairro | | `endereco.cidade` | string | Cidade | | `endereco.uf` | string | UF (sigla do estado) | | `endereco.cep` | string | CEP no formato 00000-000 | | | | | ### Destinatário | **Nome** | **Tipo** | **Descrição** | | :-------------------- | :------- | :----------------------------------- | | `codigo` | string | codigo interno do erp | | `nome` | string | Nome ou razão social do destinatário | | `documento` | string | CNPJ ou CPF do destinatário | | `tipo_pessoa` | string | `juridica` ou `fisica` | | `endereco.logradouro` | string | Nome da rua / avenida | | `endereco.numero` | string | Número do endereço | | `endereco.bairro` | string | Bairro | | `endereco.cidade` | string | Cidade | | `endereco.uf` | string | UF (sigla do estado) | | `endereco.cep` | string | CEP no formato 00000-000 | | | | | ### Itens \[array] | **Nome** | **Tipo** | **Descrição** | | :-------------- | :------- | :------------------------------- | | `sequencial` | string | Número da Nota Fiscal de Entrada | | `produto` | json | Codigo do produto ou dados | | lote | sring | Lote do item | | data\_validade | sring | formato `yyyy-mm-ddd` | | quantidade | number | Quantidade do produto | | valor\_unitario | number | Valor unitário do produto | ### Produto | Nome | Tipo | Descrição | | :--------------- | :----- | :------------------------------- | | `codigo` | string | Código do produto | | `descricao` | string | Descrição do produto | | `tipo` | string | `S` ou `L` (Sólido ou Líquido | | `unidade_medida` | string | CX, LT, BD,BB | | `peso_bruto` | number | Peso Bruto unitário do produto | | `peso_liquido` | number | Peso Líquido unitário do produto | | `peso_cubado` | number | Peso Cubado unitário do produto | | `valor_unitario` | number | Valor unitário do produto | ## **Exemplo** ```json body theme={null} [ { "documento": { "codigo": "NF654321", "tipo": "nfe", "serie": "1", "chave_acesso": "35260312345678000199550010000043211000043210", "data_emissao": "2026-03-30", "origem_id": "ERP-NFE-654321" }, "emitente": { "codigo": "EMIT0002", "nome": "INDÚSTRIA ALFA LTDA", "documento": "33.444.555/0001-66", "tipo_pessoa": "juridica", "endereco": "Rua das Indústrias", "numero": "500", "bairro": "Distrito Industrial", "cidade": "Jundiaí", "uf": "SP", "cep": "13200-000" }, "destinatario": { "codigo": "DEST0002", "nome": "DISTRIBUIDORA BETA LTDA", "documento": "44.555.666/0001-77", "tipo_pessoa": "juridica", "endereco": "Rodovia Anhanguera", "numero": "KM 70", "bairro": "Zona Rural", "cidade": "Limeira", "uf": "SP", "cep": "13480-000" }, "itens": [ { "sequencial": 1, "produto": { "codigo": "PROD010", "descricao": "Produto 010", "tipo": "S", "unidade_medida": "UN", "peso_bruto": 12.5, "peso_liquido": 12, "peso_cubado": 0.08 }, "lote": "LT20260301", "data_validade": "2027-03-01", "quantidade": 30, "valor_unitario": 22.9 }, { "sequencial": 2, "produto": { "codigo": "PROD011", "descricao": "Produto 011", "tipo": "S", "unidade_medida": "CX", "peso_bruto": 20, "peso_liquido": 19, "peso_cubado": 0.12 }, "lote": "LT20260302", "data_validade": "2026-11-15", "quantidade": 10, "peso_bruto": 200, "peso_liquido": 190, "peso_cubado": 1.2, "valor_total": 890 } ] } ] ``` ```json 200 theme={null} { "ok": true, "status": 200, "message": "Integração de documentos de saída processada", "resultado": [ { "ok": true, "acao": "insert", "tipo": "nfe", "indice": 0, "status": 200, "status_id": 2, "emitente_id": "ID EMITENTE", "valor_total": 1577, "documento_id": "ID DOCUMENTO", "status_codigo": "AGUARDANDO_ESTOQUE", "destinatario_id": "ID DESTINATARIO", "documento_codigo": "NF654321", "peso_bruto_total": 575, "itens_processados": 2, "peso_cubado_total": 3.6, "peso_liquido_total": 550 } ], "processados": 1 } ``` ## Erros comuns | **Código** | **Mensagem** | **Causa Provável** | | :--------- | :------------------------------------------------------------------ | :----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | 400 | Campos obrigatórios ausentes | Campo obrigatório não enviado no payload, como
`documento.codigo`, `documento.tipo`, `documento.data_emissao`,
`emitente.nome`, `destinatario.nome` ou itens sem `produto.codigo` e `quantidade` | | 400 | Tipo de documento inválido | Valor de `documento.tipo` diferente dos aceitos pela API. Para saída: `pedido` ou `nfe` | | 401 | Sessão inválida | Token Bearer ausente, inválido, expirado ou não reconhecido. | | 409 | Documento já vinculado a romaneio
e não pode ser reprocessado | O documento já entrou no fluxo operacional e possui vínculo em `romaneios_documentos_saida`,
impedindo atualização pela integração | | 500 | Erro interno ao processar entrada | Falha inesperada no processamento da RPC, normalmente causada por inconsistência de dados,
relacionamento inválido ou estrutura incompleta no banco | | | | | * Se o produto, emitente ou destinatário ainda não existir, será criado automaticamente vinculado à empresa. * A função respeita as **RLS policies** para garantir que o usuário só altere dados da empresa à qual está vinculado.