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 processados em paralelo: para cada grupo, o sistema gera a GNRE e envia o lote à SEFAZ. Devolve `'sucesso'` quando todos os lotes são gerados com OK; o primeiro erro aborta com a mensagem propagada.

📄️Devolve o PDF de uma guia individual

Usado pela ação **Visualizar arquivo** na tela GNRE para abrir o PDF da guia em um modal. Resposta: 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 o staging de pedidos integrados dos canais de venda, com os filtros de canal/cliente/UTM/data, busca textual `Search`, modo `OrdersNotCreated=1` (so registros que ainda nao geraram pedido) e paginacao em blocos de 1000 (`Page` -> deslocamento `Page * 1000`).

📄️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

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.

📄️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.

📄️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. 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`). Consulte a tela do frontend que monta a planilha para o layout exato das colunas.

🗃Por Pedido

15 itens