1

LAYOUT PADRÃO HOS

1. Explicações Gerais
 Campos numéricos deverão estar alinhados à direita, preenchendo com zeros à esquerda.
 Campos alfanuméricos deverão estar alinhados à esquerda, preenchendo com espaços em branco à direita.
 Campos data deverão estar no formato DDMMAAAA.
 Campos hora deverão estar no formato HHMMSS.
 Campos de valor, ou seja, os que possuem casas decimais deverão estar multiplicados por 100. Exemplo: R$
25, 53, deveram ficar 00000002553.
 Para o formato, A são campos alfanuméricos, D são campos data, H são campos hora e N são numéricos.

2. Layout Arquivo de Pedidos

Nome do Arquivo: p11111111.ped
p = fixo
11111111 = 8 caracteres para o código do cliente, alinhados a direita, preenchendo com zeros à esquerda.
.ped = extensão do arquivo
Por exemplo, para o cliente de código 1589: p00001589.ped

2.1 Registros do Arquivo

Abertura do Arquivo
ID Informação Inicio Tamanho Formato Observações
01 Tipo de registro 01 02 N Valor fixo “01”
02 Data de geração 03 08 D DDMMAAAA
03 Hora de geração 11 06 H HHMMSS

Informações do Pedido
ID Informação Inicio Tamanho Formato Observações
01 Tipo de registro 01 02 N Valor Fixo “02”
02 Código do Cliente 03 08 N Código do cliente no Fornecedor
03 Tipo de Faturamento 11 03 N 001 - A Vista
002 - A Prazo
003 – Promoção
04 Apontador de Promoção 14 05 A Aceita qualquer valor alfanumérico ou
numérico definido pelo Fornecedor
05 Tipo de Compra 19 01 A E – Estadual
I – Interestadual
OBS: Se o campo 03 for preenchido com os valores 001 ou 002 o campo 4 deve ser preenchido com 5 casas em branco.
Se o campo 03 for preenchido com o valor 003 no campo 4 deve ser informado o apontador da promoção que pode ser
um valor numérico ou alfanumérico, com até 5 caracteres, alinhados a esquerda e com espaços em branco a direita.

Itens do Pedido
ID Informação Inicio Tamanho Formato Observações
01 Tipo de registro 01 02 N Valor Fixo “03”
02 Código do Produto 03 08 N Utilizado o código referente ao
Fornecedor.
03 Código de Barras do Produto 11 13 N EAN do Produto.
04 Quantidade solicitada 24 06 N Quantidade solicitada do Produto.

Finalização do Arquivo
ID Informação Inicio Tamanho Formato Observações
01 Tipo de Registro 01 02 N Valor Fixo “99”
02 Quantidade total de Itens 03 08 N
 2

3. Layout Arquivo de Retorno

Nome do Arquivo: r11111111.ret
r = fixo
11111111 = 8 caracteres para o código do cliente, alinhados a direita, preenchendo com zeros à esquerda.
.ret = extensão do arquivo
Por exemplo, para o cliente de código 1589: r00001589.ret

3.1 Registros do Arquivo

Abertura do Arquivo
ID Informação Inicio Tamanho Formato Observações
01 Tipo de registro 01 02 N Valor Fixo “01”
02 Data de geração 03 08 D DDMMAAAA
03 Hora de geração 11 06 H HHMMSS

Informações do Retorno de Pedido

ID Informação Inicio Tamanho Formato Observações
01 Tipo de Registro 01 02 N Valor Fixo “02”
02 Código do Cliente 03 08 N Código do Cliente no Fornecedor
03 Motivo 11 02 N Informações do pedido (Tabela1)

Itens do Retorno de Pedido

ID Informação Inicio Tamanho Formato Observações
01 Tipo de registro 01 02 N Valor Fixo “03”
02 Código do Produto 03 08 N Utilizado o código referente ao
Fornecedor.
03 Código de Barras do Produto 11 13 N EAN do Produto.
04 Quantidade solicitada 24 06 N Quantidade solicitada do Produto.
05 Quantidade atendida 30 06 N Quantidade atendida pelo Fornecedor.
06 Motivo 36 02 N Informação do Item (Tabela 2)

Finalização do Arquivo
ID Informação Inicio Tamanho Formato Observações
01 Tipo de registro 01 02 N Valor Fixo “99”
02 Quantidade total de Itens 03 08 N
OBS: O arquivo de retorno deve conter todos os itens que foram enviados no arquivo de pedido, mesmo para produtos
que não tiveram quantidade atendida e também para os pedidos que não foram atendidos, este arquivo deve conter todos
os registros de produtos apenas informando o campo quantidade atendida igual a zero.

Tabela1
01 – Pedido Atendido completamente Tabela2
02 – Pedido Atendido parcialmente 50 – Item atendido Completamente
03 – Valor Mínimo não atingido 51 – Estoque Insuficiente
04 – Problemas no cadastro do Cliente 52 – Produto não cadastrado/Desativado
05 – Limite de Crédito Insuficiente 53 – Produto Bloqueado
06 – Forma de faturamento inválida 54 – Em Falta no estoque
07 – Apontador de Promoção inválido 55 – Duplicidade de produto no pedido
08 – Pedido Duplicado 56 – Produto controlado não liberado para o cliente
09 – Código de Cliente Inválido 57 – Produto bloqueado para o Estado do Cliente
10 – Pedido com Layout Incorreto 99 – Motivo não especificado
11 – Horário do Pedido Encerado
12 – Problemas com Arquivo Enviado
49 – Motivo não especificado
 3

4. Layout Arquivo Nota Fiscal

- Se o arquivo da Nota Fiscal conter mais de uma nota, repetir o cabeçalho para cada nota com seus respectivos
produtos e parcelas do boleto.
Nome do Arquivo: nfddhhmm.nfs
nf = fixo
dd = dia da geração do arquivo.
hh = hora da geração do arquivo.
mm = minuto de geração do arquivo.
.nfs = extensão do arquivo
Por exemplo: nf291030.nfs

4.1 Registros do Arquivo

Cabeçalho da Nota Fiscal
ID Informação Inicio Tamanho Formato Observações
01 Tipo de Registro 01 02 N Valor Fixo “01”
02 Número da Nota Fiscal 03 09 N
03 Data de Emissão da Nota 12 08 D DDMMYYYY
04 Hora da Emissão da Nota 20 06 H HHMMSS
05 Modelo da Nota 26 03 A
06 Série da Nota 29 04 A
07 Valor Liquido da Nota 33 12 N (10,2)
08 Valor Bruto da Nota 45 12 N (10,2)
09 Valor Total dos Produtos 57 12 N (10,2)
10 Valor Base ICMS 69 12 N (10,2)
11 Valor ICMS 81 12 N (10,2)
12 Valor Base de Calculo Reduzida 93 12 N (10,2)
13 Valor ICMS Base de Calculo 105 12 N (10,2)
Reduzida
14 Valor Base de Calculo Substituição 117 12 N (10,2)
15 Valor Substituição 129 12 N (10,2)
16 Valor Base de Calculo IPI 141 12 N (10,2)
17 Valor IPI 153 12 N (10,2)
18 Valor do Repasse de ICMS 165 12 N (10,2)
19 Valor do Frete 177 12 N (10,2)
20 Valor de Outras Despesas 189 12 N (10,2)
21 Valor do Seguro 201 12 N (10,2)
22 Valor do Desconto dado Sobre o 213 12 N (10,2)
Total da Nota

Itens da Nota Fiscal

ID Informação Inicio Tamanho Formato Observações
01 Tipo de Registro 01 02 N Valor Fixo “02”
02 Número da Nota Fiscal 03 09 N
03 Código do Produto 12 08 N Utilizado o código referente ao
Fornecedor.
04 Código de Barras do Produto 20 13 N EAN do Produto.
05 Quantidade do Produto 33 06 N Quantidade solicitada do Produto.
06 Alíquota de Compra do Produto 39 02 A ST, se Substituição Tributária
IS, se Isento
NI, se não incidente
07, se 07%
12, se 12%
17, se 17%
18, se 18%
25, se 25%
07 Valor Bruto Unitário do Produto 41 12 N(10,2)
08 Valor Liquido Unitário do Produto 53 12 N(10,2)
09 Preço Máximo Consumidor 65 12 N(10,2)
Unitário
 4

10 Percentual de Desconto no Produto 77 12 N(10,2)

11 Valor Unitário do Desconto no 89 12 N(10,2)
Produto
12 Valor Unitário da Base de Cálculo 101 12 N(10,2)
ICMS
13 Valor Unitário ICMS 113 12 N(10,2)
14 Valor Unitário da Base de Cálculo 125 12 N(10,2)
Substituição
15 Valor Unitário Substituição 137 12 N(10,2)
16 Valor Unitário IPI 149 12 N(10,2)
17 Valor Unitário do Repasse de 161 12 N(10,2)
ICMS
18 Valor Máximo Agregado Unitário 173 12 N(10,2)
19 Lote do Produto 185 10 A
20 Validade do Produto 195 08 D
21 Descrição do Produto 203 60 A
OBS: Para cada Variação de Lote ou de Validade Dentro de um Mesmo Item deve ser gerado um novo registro do tipo
“02”. Exemplo se um determinado item possuir dois lotes diferentes (dentro da mesma nota) devem ser gerados dois
registros tipo “02”, com todos os dados do item.

Parcelas do Boleto da Nota Fiscal

ID Informação Inicio Tamanho Formato Observações
01 Tipo de Registro 01 02 N Valor Fixo “03”
02 Número da Nota Fiscal 03 09 N Número da Nota que Originou o boleto
03 Numero de Identificação do Boleto 12 30 A
04 Numero da Parcela 42 02 N
05 Data de Emissão 44 08 D
06 Data de Vencimento 52 08 D
07 Valor da Parcela 60 12 N(10,2)
08 Juros por dia (%) 72 04 N(2,2)
09 Multa (%) 76 04 N(2,2)
10 Desconto por dia de Antecipação 80 04 N(2,2)
(%)
11 Desconto Financeiro (%) 84 04 N(2,2)
12 Valor Total do Boleto 88 12 N(10,2)
13 Número do Banco 100 05 A
13 Número da Agência 105 10 A
14 Número da Conta 115 10 A

5. Arquivo de Relacionamentos
Nome do Arquivo: Dicionario.txt
Dicionario.txt = Fixo

5.1 Registros do Arquivo

ID Informação Inicio Tamanho Formato Observações
01 Código do produto no Fornecedor 01 07 N Informar neste campo o código que o
produto possui internamente.
02 Código de Barras do Produto 08 13 N
03 Descrição do Produto 21 60 A
04 Fração do Produto 81 03 N Informar a Fração de venda do item no
fornecedor

6. Caminhos no Servidor de FTP do Fornecedor

ID Diretório Caminho Observações
01 Pedido /usuário/pedido/
02 Retorno /usuário/retorno/
03 Notas Fiscais /usuário/espelho/
04 Dicionário /usuário/
 5

OBS: Estes caminhos não são obrigatórios, é uma sugestão para facilitar a organização dos arquivos.