Pedidos

📄️Lista pedidos

Lista os pedidos da empresa autenticada — endpoint compartilhado entre **Outbound** (default `IDStatusOrder=1` + `OrderBy=ASC`), **Pedidos**, **Retirada em Mãos** (`IDStatusOrder=17&Budget=0&SkuView=0`) e demais telas que listam pedidos. Paginação fixa em **2000 registros por página** (`Page=N` → offset `N*2000`).

📄️Cria pedido

Cria um pedido da empresa autenticada — endpoint **compartilhado** por todas as telas que criam pedidos (**Pedidos**, **PDV/Store Front**, **Ordem de serviço**, devolução/Reversa, importação). A tela de **Ordem de serviço** usa este mesmo endpoint enviando o tipo de pedido marcado como ordem de serviço; o subconjunto de campos enviado por cada tela varia.

📄️Lista eventos do pedido (Log Pedidos)

Lista o histórico de ações realizadas em pedidos (`OrderEvents`), com `EventDescription`, executor (`User`), `Order` e conta já resolvidos. Paginação fixa em **5000 registros por página** (`Page=N` → offset `N*5000`), ordenado por `IDOrderEvents` decrescente (mais recentes primeiro). Em contexto multi-conta (`accountname = all`), traz todas as contas acessíveis ao usuário.

📄️Lista pacotes (fila do Pré-Romaneio)

Lista pacotes (`Packages`) com dados do pedido, transportadora, código de rastreio (`ShippingId`), status do pedido (`IDStatusOrder` / `StatusOrder`), status do pacote (`IDStatusPackage` / `StatusPackage`), CD (`DistributionCenterName`), conta (`AccountName`) e romaneio atual (`IDOrdersCarrierCollectionList`). Restrito automaticamente pelos CDs habilitados ao usuário logado. Paginado em blocos de 5000 (`Page` = número; offset = `Page * 5000`).

📄️Lista as etiquetas (tags) dos pedidos

Retorna o conjunto distinto de tags aplicadas aos pedidos da empresa, em ordem alfabética. Quando um `IDOrder` é informado, restringe à(s) tag(s) daquele pedido.

📄️Lista GNRE (ou apuração DIFAL com Summary=1)

Endpoint compartilhado pelas telas **GNRE** e **Apuração DIFAL**. O comportamento depende da querystring `Summary`:

📄️Gera GNRE em massa para os pedidos selecionados

Aciona a geração de GNRE para uma lista de pedidos. Para cada pedido valida que existe NF principal (`Main=1`) com status emitido (`IDStatusInvoice=3`). Os pedidos válidos são agrupados por `AccountNameInvoice` (faturador) e enviados em paralelo ao processo `/nfe/gnre/enviarlote.php?an=<AccountName>&ignoreconfig=1&sync=1`, que cria os registros em `Gnre` e envia o lote à SEFAZ. Devolve `'sucesso'` quando todas as chamadas ao processo retornam OK; o primeiro erro do processo aborta com a mensagem propagada.

📄️Devolve o PDF de uma guia individual

Sistema **PHP** (`gnreFileGet`, runtime `provided.al2`) — não documentado a partir do código Node deste repositório. Usado pela ação **Visualizar arquivo** na tela GNRE para abrir o PDF da guia em um modal. Resposta esperada: stream/URL do PDF correspondente ao `IDGnre` informado.

📄️Baixa ZIP com os PDFs das guias selecionadas

Recebe um array de `IDGnre` e gera um arquivo ZIP contendo `<IDGnre>.pdf` para cada guia válida da empresa. O ZIP é gravado em `Temp/<uuid>.zip` no bucket S3 e retornado por meio de **URL assinada válida por 2 dias**. Em paralelo, dispara um e-mail (SES, modelo `Html/exportar-XML.html`) para o usuário solicitante com o mesmo link. O corpo da resposta é a URL assinada.

📄️Lista pedidos em rastreamento

Lista pedidos com informação de rastreio agregada. Retorna até 3000 itens por página (`Page` controla o offset = `Page * 3000`). Inclui dados do pedido, último evento de tracking da transportadora, status calculados de entrega e indicadores de pontualidade.

🗃Detalhe

2 itens

📄️Lista o staging de pedidos integrados

Lista todas as linhas do staging dos canais de venda. Filtros: `IDCompanyIntegration`, `IDOrder`, `OrderFrom`, `PackageId`, intervalos de data, status do canal/pedido/NF, dados do cliente.

📄️Cria pedido manualmente (puxa do canal pelo código origem)

Quando o canal não enviou o pedido automaticamente, este endpoint faz um **pull explícito** usando o código origem informado. Útil para 'puxar' pedidos pontuais. `ShippingId` é obrigatório apenas para Mercado Livre OnSite (`IDTypeCompanyIntegration=1`).

🗃Detalhe

2 itens

📄️Solicita o pacote ZIP com os XMLs de NFe dos pedidos

Gera de forma assíncrona um arquivo ZIP com os XMLs (autorização, cancelamento, inutilização, carta de correção) dos pedidos ou arquivos informados, sobe o ZIP em armazenamento temporário e envia o link de download por e-mail ao usuário que disparou a requisição. A resposta imediata é a URL pré-assinada de download (válida por 2 dias). Os filtros recebidos por query string entram no nome do arquivo gerado.

📄️Importa um pedido a partir do XML de uma NF-e (PHP)

Recebe o XML autorizado de uma NF-e e cria o pedido no idworks com itens, impostos, cliente, endereços e pagamentos extraídos. Quando os SKUs não estão cadastrados, a importação falha — exceto se a parametrização **Criar SKU automaticamente quando não existir** estiver ativa. Quando configurado, valida a assinatura junto à SEFAZ antes de importar. Implementação no repositório PHP (`src/Lambda/orderImportXml/index.php`).

📄️Baixa o template de planilha para importação ou edição em lote

Devolve a planilha modelo correspondente ao tipo informado: pedidos (padrão), atualização de status de pedido, contas a pagar/receber, impostos de marketplace e ordens de serviço. Implementação no repositório PHP (`src/Lambda/orderFileTemplateExport/index.php`).

📄️Importa planilha de pedidos / contas a pagar / contas a receber em lote

Recebe o arquivo enviado via multipart, salva no armazenamento temporário, cria um job e dispara o processamento assíncrono em `orderTemplateImport`. A resposta retorna imediatamente o identificador do job — o resultado é enviado posteriormente por e-mail. Se já existe um job em andamento com o mesmo hash de arquivo, devolve o job existente.

📄️Aplica atualizações em lote a partir do template

Recebe os dados editados na planilha de template e aciona a rotina de atualização correspondente (ex.: alteração de status em massa pelo `Type=OrderStatus`). Implementação no repositório PHP (`src/Lambda/orderFileTemplateExport/index.php`). Contrato exato não confirmado (PHP) — consulte a tela do frontend que monta a planilha.

🗃Por Pedido

15 itens