ForHosting KIT · PDF e documentos

Gere um romaneio de pedido sem preços

O pedido ORD-10482, com 2 linhas e 3 unidades no total, vira um romaneio numerado com o endereço de entrega e as quantidades, sem preços, impostos ou dados de cobrança. Informe o número do pedido, o endereço e os itens. Grátis no seu navegador.

  • Grátis
  • Funciona no seu navegador
  • Sem cadastro
  • Seus dados não saem do seu aparelho
Use pelo WebAPIE-mailTelegramApp em breve

Roda direto no seu navegador. Grátis, sem cadastro — seus dados não são enviados para lugar nenhum.

Crie um romaneio para acompanhar a remessa sem transformá-lo em uma fatura. Informe o número do pedido, um endereço de entrega estruturado e um ou mais itens com suas quantidades. O gerador valida os dados, numera cada linha, calcula o total de unidades e devolve campos estruturados reutilizáveis e um documento em texto pronto para impressão. Preços, impostos, condições de pagamento e dados de cobrança são excluídos de propósito, mantendo o resultado voltado à separação, à conferência do destinatário e ao conteúdo do pacote.

Monte o documento com dados de expedição

Um romaneio responde a uma questão prática do armazém: o que deve estar neste pacote e para onde ele vai? Comece pelo número utilizado por sua loja, depósito ou sistema de gestão de pedidos. Em seguida, forneça o destinatário e o destino em campos estruturados para que cada parte possa ser reutilizada depois.

Adicione cada produto separado em uma linha própria, com nome, quantidade inteira positiva e SKU opcional. O gerador preserva a ordem informada, atribui números visíveis às linhas, normaliza espaços excedentes e calcula tanto a quantidade de linhas distintas quanto o total de unidades. O resultado oferece um objeto estruturado para automações e um romaneio em texto para imprimir, salvar ou inserir em outro layout.

Como o algoritmo não inventa dados ausentes, o documento permanece rastreável às informações fornecidas pela sua operação. Uma solicitação sem itens falha para não criar um registro de remessa vazio e potencialmente enganoso.

Mantenha o romaneio separado da fatura

O romaneio e a fatura podem tratar do mesmo pedido, mas têm finalidades diferentes. A fatura cobra ou registra um pagamento e costuma apresentar preços unitários, descontos, impostos, totais, endereço de cobrança, instruções de pagamento e termos legais. Esta capacidade não gera nenhum desses campos.

A saída identifica o documento como romaneio e contém somente referência do pedido, destino, identificação e quantidade dos itens, contagens e uma versão pronta para impressão. Essa separação ajuda em presentes, em operações nas quais o setor de compras recebe documentos financeiros por outro canal ou quando a equipe do depósito não precisa acessar condições comerciais. Também impede que outros sistemas interpretem um comprovante de expedição como valor a pagar.

Para cálculos contábeis ou cobrança, use um fluxo específico de faturamento. Aqui, as quantidades são fatos operacionais usados para comparar o conteúdo físico com o pedido sem expor preços.

Valide, imprima e automatize com consistência

Use a resposta estruturada quando outro sistema precisar arquivar o romaneio, mapear as linhas para um modelo PDF, montar um conjunto de etiquetas ou comparar quantidades separadas com leituras de scanner. Use o documento em texto quando uma versão simples e legível for suficiente. Os componentes obrigatórios do endereço são validados individualmente; empresa, segunda linha, região, código postal e SKU opcionais são omitidos quando vazios, em vez de aparecerem como valores nulos.

As quantidades devem ser inteiros positivos, evitando linhas ambíguas com fração ou zero em expedições comuns. O gerador é determinístico: entradas idênticas produzem saídas idênticas, sem rede, horário atual, identificador aleatório, consulta de estoque ou enriquecimento de produto. Ele não confirma disponibilidade, aceitação do endereço pela transportadora nem despacho efetivo.

Faça essas verificações nos sistemas adequados antes de considerar o documento uma autorização para enviar o pacote.

Inclua um romaneio em uma compra online

Transforme linhas confirmadas da separação em um documento legível sem revelar preços nem dados de pagamento.

Apoie a conferência no armazém

Forneça linhas numeradas e o total de unidades para comparação com os produtos colocados na caixa.

Registre remessas de substituição

Crie um registro do conteúdo de uma troca ou garantia quando uma fatura não for apropriada.

O romaneio inclui preços?

Não. Ele exclui deliberadamente preços, descontos, impostos, condições de pagamento e totais de fatura.

O que acontece se a lista de itens estiver vazia?

A solicitação falha com um erro de entrada inválida, pois o romaneio precisa conter pelo menos um item.

Um item pode ficar sem SKU?

Sim. Nome e quantidade inteira positiva são obrigatórios; o SKU é opcional e é omitido quando está vazio.

O endereço postal é validado com uma transportadora?

Não. Os campos obrigatórios são verificados e formatados, mas a entrega não é confirmada e nenhuma transportadora é contatada.

Qual é a diferença entre romaneio e fatura?

O romaneio mostra o que vai na caixa e para onde; a fatura registra um pagamento com preços, impostos e condições. Este documento deixa de fora, de propósito, qualquer dado financeiro, o que ajuda quando o pacote é um presente.

Tudo nesta página está disponível via API. Esta seção é para equipes que querem integrar a ferramenta aos próprios sistemas; quem não precisa disso pode simplesmente usar a ferramenta acima.

POSThttps://api.kit.forhosting.com/doc/packing-slip-generate

Autenticação por token Bearer. Um único POST coloca a tarefa na fila; o resultado chega por webhook ou link assinado.

curl -X POST https://api.kit.forhosting.com/doc/packing-slip-generate \
  -H "Authorization: Bearer $KIT_KEY" \
  -H "Content-Type: application/json" \
  -d '{"order_number":"ORD-10482","shipping_address":{"name":"Morgan Lee","company":"Northwind Studio","address_line_1":"48 Harbor Street","address_line_2":"Suite 3B","city":"Portland","region":"ME","postal_code":"04101","country":"US"},"items":[{"name":"Canvas Tool Roll","quantity":2,"sku":"CTR-NAVY"},{"name":"Brass Measuring Gauge","quantity":1,"sku":"BMG-01"}]}'
{
  "order_number": "ORD-10482",
  "shipping_address": {
    "name": "Morgan Lee",
    "company": "Northwind Studio",
    "address_line_1": "48 Harbor Street",
    "address_line_2": "Suite 3B",
    "city": "Portland",
    "region": "ME",
    "postal_code": "04101",
    "country": "US"
  },
  "items": [
    {
      "name": "Canvas Tool Roll",
      "quantity": 2,
      "sku": "CTR-NAVY"
    },
    {
      "name": "Brass Measuring Gauge",
      "quantity": 1,
      "sku": "BMG-01"
    }
  ]
}
{
  "task_id": "tsk_a1b2c3d4e5f6a1b2c3d4e5f6",
  "type": "doc.packing_slip_generate",
  "status": "queued",
  "_links": {
    "result": "/tasks/tsk_…/result"
  }
}

A API é assíncrona: cada chamada devolve um task_id na hora. Se preferir polling, consulte o status a até 1 requisição por segundo.

por chamadaUS$ 0,002

Preço publicado, sem tokens nem créditos escondidos. Tarefa que falha não é cobrada.

max_mb25
max_pages200
HTTPCódigoO que significa
401unauthorizedToken ausente ou inválido. Confira o header Authorization.
402insufficient_balanceSaldo insuficiente para esta tarefa. Faça uma recarga e tente de novo.
404unknown_typeEsse tipo de tarefa não existe. Confira o campo type no catálogo.
429rate_limitedMuitas requisições em pouco tempo. Espere um instante e tente de novo.
Quanto custa uma solicitação de API?

Cada solicitação de API custa US$ 0,002. A versão determinística no navegador pode funcionar sem enviar dados da remessa a um modelo remoto.

Ver a documentação completa do KIT →