Índice

1 Layout de importação de venda
2 Layout de importação de produto
- 2.1 Modelo 1
  - 2.1.1 INFORMAÇÕES GERAIS
- 2.2 Geração de arquivo em CSV

Layout de importação de venda

INFORMAÇÕES GERAIS

APRESENTAÇÃO

Este guia prático visa orientar a geração do arquivo com os dados concernentes à importação de venda.

NOME DO ARQUIVO

O nome do arquivo será o número do pedido adicionado no bloco 101 do arquivo, sendo que, no arquivo conterá apenas um pedido com vários itens.

ORGANIZAÇÃO DOS REGISTROS DENTRO DO ARQUIVO

Dentro de cada bloco os registros dever ser dispostos de forma sequencial e ascendente. Conforme estruturados (ver Tabela registros e de obrigatoriedade de cada modelo de arquivo).

OBSERVAÇÕES

Se especificado “O” na coluna de obrigatoriedade, significa que o registro deve ser sempre apresentado.

Se especificado “N” na coluna de obrigatoriedade, significa que o registro não é obrigatório ser apresentado.

PREENCHIMENTO DE CAMPOS

Para campos alfanuméricos, representados por "C", podem ser usados todos os caracteres da Tabela ASCII, exceto os caracteres "|" (Pipe, código 124 da Tabela ASCII) e os não-imprimíveis (caracteres 00 a 31 da Tabela ASCII). :Todos os campos alfanuméricos terão tamanho máximo de 255 caracteres, exceto se houver indicação distinta, onde, neste caso, este tamanho distinto prevalecerá. Não poderão ser informados espaços “em branco” no início ou ao final da informação.

Para campos numéricos, representados por "N", podem ser usados algarismos das posições de 48 a 57 da Tabela ASCII.

Para campos numéricos nos quais há indicação de casas decimais:

a) deverão ser preenchidos sem os separadores de milhar, sinais ou quaisquer outros caracteres (tais como: "." "-""%"), devendo o ponto ser utilizado como separador decimal (ponto: caractere 46 da Tabela ASCII);

b) não há limite de caracteres para os campos numéricos. O caractere * (Asterisco) aposto ao lado do tamanho do campo indica que o campo deve ser informado com aquela quantidade exata de caracteres;

c) observar a quantidade máxima de casas decimais que constar no respectivo campo (Ex. para os campos alíquota de ICMS com tamanho máximo de 06 caracteres considerando o ponto e duas decimais, o valor máximo a ser informado é 999.99);

d) preencher os valores percentuais desprezando-se o símbolo (%), sem nenhuma convenção matemática.

Exemplo (valores monetários, quantidades, percentuais, etc):

$ 1.129.998,99 → |1129998.99|

1.255,42 → |1255.42|

234,567 → |234.567|

10.000 → |10000|

10.000,00 → |10000| ou |10000.00|

17,00 % → |17.00| ou |17|

18,50 % → |18.5| ou |18.50|

30 → |30|

1.123,456 Kg → |1123.456|

0,010 litros → |0.010|

0,00 → |0| ou |0.00|

0 → |0|

campo vazio → ||

e) Caracteres maiúsculos e minúsculos são considerados iguais.

Modelo 1

ALTERAÇÕES

Alterações no leiaute a partir da versão 1.2.

1) Adicionando o campo Cest para que o mesmo seja cadastrado junto ao produto.

TABELA REGISTROS E DE OBRIGATORIEDADE DE APRESENTAÇÃO

Bloco	Descrição	Reg.	Nível	Ocor.
001	Abertura do documento e identificação do modelo do leiaute	001	0	1
101	Identificação do pedido	101	1	1
201	Itens do pedido	201	2	1:N
301	Encerramento do arquivo	301	0	1

REGISTRO 001: ABERTURA DO DOCUMENTO E IDENTIFICAÇÃO DO MODELO DO LEIAUTE

Registro obrigatório e corresponde ao primeiro registro do arquivo.

Nº	Campo	Descrição	Tipo	Tam	Dec	Obrig
01	REG	Texto fixo contendo “001”.	C	003	-	O

Observações: Nível hierárquico – 0 Ocorrência - um por arquivo.

Campo 01 (REG) - Valor Válido: [001]

REGISTRO 101: IDENTIFICAÇÃO DO PEDIDO

Registro obrigatório e corresponde a identificação do pedido.

Nº	Campo	Descrição	Tipo	Tam	Dec	Obrig
01	REG	Texto fixo contendo “101”.	C	003	-	O
02	NRO_PEDIDO	Identificação do número do pedido.	C	020	-	O

Observações: Nível hierárquico – 1 Ocorrência – um por arquivo.

Campo 01 (REG) - Valor Válido: [101]

Campo 02 (NRO_PEDIDO) - Preenchimento: informar o número do pedido.

Obs.: O número do pedido deve ser único, não podendo ser repetido no mesmo arquivo.

REGISTRO 201: ITENS DO PEDIDO

Registro obrigatório para discriminar os itens do pedido.

Nº	Campo	Descrição	Tipo	Tam	Dec	Obrig
01	REG	Texto fixo contendo “201”.	C	003	-	O
02	CODIGO_BARRA	Identificação do produto por meio de código de barras.	C	050	-	N
03	REFERENCIA	Identificação do produto por meio de referência.	C	050	-	N
04	DESCRICAO	Descrição do produto.	C	080	-	O
05	UNIDADE	Unidade do item.	C	004	-	O
06	NCM	Código NCM.	N	008	-	O
07	TEM_ST	Verificação de existência de ST no item.	C	001	-	O
08	ALQ_ICMS	Alíquota do ICMS.	N	-	02	O
09	ALQ_COFINS	Alíquota do COFINS.	N	-	02	O
10	ALQ_PIS	Alíquota do PIS.	N	-	02	O
11	QUANTIDADE	Quantidade do item.	N	-	02	O
12	VL_UNIT	Valor unitário do item.	N	-	02	O
13	PERC_DESC	Percentual de desconto do item.	N	-	02	O
14	PERC_ASC	Percentual de acréscimo do item.	N	-	02	O
15	CST_PIS	Código da situação tributária referente ao PIS	N	002	-	N
16	CST_COFINS	Código da situação tributária referente ao COFINS	N	002	-	N
17	CEST	Código Cest	N	007	-	N

Observações: Nível hierárquico – 2 Ocorrência - 1:N (um ou vários por registro 101)

Campo 01 (REG) - Valor Válido: [201]

Campo 02 (CODIGO_BARRA) - Preenchimento: código de barras do produto que será inserido como item.

Campo 03 (REFERENCIA) - Preenchimento: referência do produto que será ser inserido como item.

Campo 04 (DESCRICAO) - Preenchimento: informar a descrição do produto.

Campo 05 (UNIDADE) - Preenchimento: informar a unidade de medida de comercialização do item utilizada no pedido.

Campo 06 (NCM) - Preenchimento: informar a classificação fiscal do produto.

Campo 07 (TEM_ST) – Valores válidos: [S, N]

Preenchimento: informar se há existência de ST no item.

Campo 08 (ALQ_ICMS) - Preenchimento: informar a alíquota do ICMS.

Campo 08 (ALQ_COFINS) - Preenchimento: informar a alíquota do COFINS.

Campo 09 (ALQ_PIS) - Preenchimento: informar a alíquota do PIS.

Campo 11 (QUANTIDADE) - Preenchimento: informar a quantidade do item.

Validação: o valor informado no campo deve ser maior que “0.00” (zero).

Campo 12 (VL_UNIT) - Preenchimento: informar o valor unitário do item.

Validação: o valor informado no campo deve ser maior que “0.00” (zero).

Campo 13 (PERC_DESC) - Preenchimento: informar o percentual do desconto comercial.

Campo 14 (PERC_ASC) - Preenchimento: informar o percentual do acréscimo comercial.

Campo 15 (CST_PIS) - Preenchimento: o campo deverá ser preenchido com o código da Situação Tributária de PIS.

Campo 16 (CST_COFINS) - Preenchimento: o campo deverá ser preenchido com o código da Situação Tributária de COFINS.

Campo 17 (CEST) - Preenchimento: o campo deverá ser preenchido com o Código Cest, apenas os números.

Obs.: Os campos CODIGO_BARRA e REFERENCIA não são obrigatórios o preenchimento dos mesmos, entretanto, é necessário que pelo menos um dos campos esteja com valor para que seja feita a validação do produto que será inserido como item do pedido. Sendo preferencial a inserção de CODIGO_BARRA.

Os campos CST_PIS e CST_COFINS não são obrigatórios o preenchimento dos mesmo, quando não tiver informações, ocorrerá as seguintes regras: em caso da alíquota de PIS e/ou COFINS for maior que “0.00” (zero), o produto será preenchido com “01”, senão será preenchido com “07”. (REVOGADO).

Os campos CST PIS e CST COFINS não são obrigatórios, quando não tiver informações, ocorrerá as seguintes regras: se a empresa for Simples Nacional será preenchido 99, se for lucro real ou lucro presumido 00 (Vazio).

Os campos Alíquota PIS e Alíquota COFINS não são obrigatórios, quando não tiver informações, ocorrerá as seguintes regras: se a empresa for Simples Nacional será preenchido 0%; se for lucro real PIS: 1,65% / COFINS: 7,60%; lucro presumido PIS: 0,65% / COFINS: 3,00%.

A Tela para cadastro fiscal do produto será aberta apenas se o produto não for encontrado no sistema e se a opção “Tem ST” estiver como SIM.

REGISTRO 301: ENCERRAMENTO DO ARQUIVO

Registro obrigatório e corresponde ao último registro do arquivo.

Nº	Campo	Descrição	Tipo	Tam	Dec	Obrig
01	REG	Texto fixo contendo “301”.	C	003	-	O

Observações: Nível hierárquico – 0 Ocorrência - um por arquivo.

Campo 01 (REG) - Valor Válido: [301]

EXEMPLO

001|

101|19875|

201|789466||Teste Importacao 1|UN|99999999|N|0.00|0.00|0.00|2.00|10.00|0.00|0.00|||

201|789465||Teste Importacao 2|UN|99999999|N|0.00|0.00|0.00|2.00|10.00|0.00|0.00|||

201|789464||Teste Importacao 3|UN|99999999|N|0.00|0.00|0.00|2.00|10.00|0.00|0.00|||

201|789463||Teste Importacao 4|UN|99999999|N|0.00|0.00|0.00|2.00|10.00|0.00|0.00|||

201|789462||Teste Importacao 5|UN|99999999|N|0.00|0.00|0.00|2.00|10.00|0.00|0.00|||

301|

Modelo 2

ALTERAÇÕES

Alterações no leiaute a partir da versão 1.1.

Alterado a quantidade de registros 102 – Identificação do Pedido para apenas 1 por arquivo. Além de ser definido o número do pedido como nome do arquivo.

TABELA REGISTROS E DE OBRIGATORIEDADE DE APRESENTAÇÃO

Bloco	Descrição	Reg.	Nível	Ocor.
002	Abertura do documento e identificação do modelo do leiaute	002	0	1
102	Identificação do pedido	102	1	1
202	Itens do pedido	202	2	1:N
302	Encerramento do arquivo	302	0	1

REGISTRO 002: ABERTURA DO DOCUMENTO E IDENTIFICAÇÃO DO MODELO DO LEIAUTE

Registro obrigatório e corresponde ao primeiro registro do arquivo.

Nº	Campo	Descrição	Tipo	Tam	Dec	Obrig
01	REG	Texto fixo contendo “002”.	C	003	-	O

Observações: Nível hierárquico – 0 Ocorrência - um por arquivo.

Campo 01 (REG) - Valor Válido: [002]

REGISTRO 102: IDENTIFICAÇÃO DO PEDIDO

Registro obrigatório e corresponde a identificação do pedido.

Nº	Campo	Descrição	Tipo	Tam	Dec	Obrig
01	REG	Texto fixo contendo “102”.	C	003	-	O
02	NRO_PEDIDO	Identificação do número do pedido.	C	020	-	O

Observações: Nível hierárquico – 1 Ocorrência – um por arquivo.

Campo 01 (REG) - Valor Válido: [102]

Campo 02 (NRO_PEDIDO) - Preenchimento: informar o número do pedido.

Obs.: O número do pedido deve ser único, não podendo ser repetido no mesmo arquivo.

REGISTRO 202: ITENS DO PEDIDO

Registro obrigatório para discriminar os itens do pedido.

Nº	Campo	Descrição	Tipo	Tam	Dec	Obrig
01	REG	Texto fixo contendo “202”.	C	003	-	O
02	CODIGO_BARRA	Identificação do produto por meio de código de barras.	C	050	-	N
03	REFERENCIA	Identificação do produto por meio de referência.	C	050	-	N
04	VL_UNIT	Valor unitário do item.	N	-	02	O
05	QUANTIDADE	Quantidade do item.	N	-	02	O

Observações:

Nível hierárquico – 2

Ocorrência - 1:N (um ou vários por registro 102)

Campo 01 (REG) - Valor Válido: [202]

Campo 02 (CODIGO_BARRA) - Preenchimento: Código de barras do produto que será inserido como item.

Campo 03 (REFERENCIA) - Preenchimento: referência do produto que será ser inserido como item.

Campo 04 (VL_UNIT) - Preenchimento: informar o valor unitário do item.

Validação: o valor informado no campo deve ser maior que “0.00” (zero).

Campo 05 (QUANTIDADE) - Preenchimento: informar a quantidade do item.

Validação: o valor informado no campo deve ser maior que “0.00” (zero).

Obs.: Os campos CODIGO_BARRA e REFERENCIA não são obrigatórios o preenchimento dos mesmos, entretanto, é necessário que pelo menos um dos campos esteja com valor para que seja feita a validação do produto que será inserido como item do pedido. Sendo preferencial a inserção de CODIGO_BARRA.

REGISTRO 302: ENCERRAMENTO DO ARQUIVO

Registro obrigatório e corresponde ao último registro do arquivo.

Nº	Campo	Descrição	Tipo	Tam	Dec	Obrig
01	REG	Texto fixo contendo “302”.	C	003	-	O

Observações:

Nível hierárquico – 0

Ocorrência - um por arquivo.

Campo 01 (REG) - Valor Válido: [302]

3. EXEMPLO

002|

102|19875|

202|789466||2.00|10.00|

202|789465||2.00|10.00|

202|789464||2.00|10.00|

202|789463||2.00|10.00|

202|789462||2.00|10.00|

302|

Modelo 3

TABELA REGISTROS E DE OBRIGATORIEDADE DE APRESENTAÇÃO

Bloco	Descrição	Reg.	Nível	Ocor.
003	Abertura do documento e identificação do modelo do leiaute	003	0	1
103	Identificação do pedido	103	1	N
203	Identificação do Cliente	203	2	1:1
303	Endereço de Entrega	303	3	1:1
403	Itens do pedido	403	2	1:N
503	Encerramento do arquivo	503	0	1

REGISTRO 003: ABERTURA DO DOCUMENTO E IDENTIFICAÇÃO DO MODELO DO LEIAUTE

Registro obrigatório e corresponde ao primeiro registro do arquivo.

Nº	Campo	Descrição	Tipo	Tam	Dec	Obrig
01	REG	Texto fixo contendo “003”.	C	003	-	O

Observações: Nível hierárquico – 0 Ocorrência - um por arquivo.

Campo 01 (REG) - Valor Válido: [003]

REGISTRO 103: IDENTIFICAÇÃO DO PEDIDO

Registro obrigatório e corresponde a identificação do pedido.

Nº	Campo	Descrição	Tipo	Tam	Dec	Obrig
01	REG	Texto fixo contendo “103”.	C	003	-	O
02	NRO_PEDIDO	Identificação do número do pedido.	C	020	-	O

Observações: Nível hierárquico – 1 Ocorrência – um por arquivo.

Campo 01 (REG) - Valor Válido: [103]

Campo 02 (NRO_PEDIDO) - Preenchimento: informar o número do pedido.

Obs.: O número do pedido deve ser único, não podendo ser repetido no mesmo arquivo.

REGISTRO 203: IDENTIFICAÇÃO DO CLIENTE

Registro não obrigatório e corresponde a identificação do cliente.

Nº	Campo	Descrição	Tipo	Tam	Dec	Obrig
01	REG	Texto fixo contendo “203”.	C	003	-	O
02	CNPJ_CPF	CNPJ/CPF do cliente	N	018	-	O
03	RAZAO_SOCIAL	Razão social do cliente	C	080	-	O
04	FANTASIA	Fantasia do cliente	C	080	-	O
05	INSC_RG	Inscrição estadual/RG do cliente	C	020	-	O
06	REGIME_APURA	Regime de apuração do cliente	N	001	-	O
07	CONTRIBUINTE_ICMS	Identificação Contribuinte ICMS	N	001	-	O
08	CEP	CEP do endereço de fatura	N	008	-	O
09	UF	UF do endereço de fatura do cliente	C	002	-	O
10	PAIS	País do endereço de fatura	C	025	-	O
11	TIPO	Tipo endereço de fatura	C	025	-	N
12	LOGRADOURO	Logradouro de fatura	C	070	-	O
13	COMPLEMENTO	Complemento de endereço	C	030	-	N
14	NUMERO	Número de endereço	N	-	-	O
15	BAIRRO	Bairro do endereço de fatura	C	050	-	O
16	CIDADE	Cidade do endereço de fatura	C	050	-	O
17	FONE	Telefone do cliente	C	015	-	N
18	FONE_OUTRO	Telefone 2 do cliente	C	015	-	N
19	CONTATO	Contato com o cliente	C	030	-	N
20	INC_ALTERACAO	Informação se o cadastro será incluso ou alterado	C	001	-	O

Observações:

Nível hierárquico – 2

Ocorrência – 1:1 (um ou por registro 103)

Campo 01 (REG) - Valor Válido: [203]

Campo 02 (CNPJ_CPF) - Preenchimento: informar o CNPJ/CPF do cliente.

Obs.: O CNPJ/CPF deve ser único, não podendo ser repetido no mesmo pedido.

Campo 06(REGIME_APURA) - Preenchimento: Regime de Apuração que o cliente se encontra, o campo aceitará os seguintes valores:

0	Nenhum
1	RPA
2	Simples Nacional
3	Lucro Real

Campo 06(CONTRIBUINTE_ICMS) - Preenchimento: Regime de Contribuição que o cliente se encontra, o campo aceitará os seguintes valores:

1	Sim
2	Isento
9	Não

Campo 11(TIPO) – Preenchimento: Tipo de endereço do cliente. Exemplos: Avenida, Rua, Praça, etc.

Campo 15(INC_ALTERACAO) – Preenchimento:

Este campo deverá ser preenchido com I(Inclusão) ou A(Alteração) ou N(Não alterar), quando for a opção de alteração ele encontrará o registro e alterará o mesmo

REGISTRO 303: ENDEREÇO DE ENTREGA DO CLIENTE

Registro não obrigatório e corresponde ao endereço de entrega do cliente.

Nº	Campo	Descrição	Tipo	Tam	Dec	Obrig
01	REG	Texto fixo contendo “303”.	C	003	-	O
02	CEP	CEP do endereço de fatura	N	008	-	O
03	UF	UF do endereço de fatura do cliente	C	002	-	O
04	PAIS	País do endereço de fatura	C	025	-	O
05	TIPO	Tipo endereço de fatura	C	025	-	N
06	LOGRADOURO	Logradouro de fatura	C	070	-	O
07	COMPLEMENTO	Complemento de endereço	C	030	-	N
08	NUMERO	Número de endereço	N	-	-	O
09	BAIRRO	Bairro do endereço de fatura	C	050	-	O
10	CIDADE	Cidade do endereço de fatura	C	050	-	O
11	FONE	Telefone do cliente	C	015	-	N
12	FONE_OUTRO	Telefone 2 do cliente	C	015	-	N
13	CONTATO	Contato com o cliente	C	030	-	N

Observações:

Nível hierárquico – 3

Ocorrência – 1:1 (um ou por registro 203)

Campo 01 (REG) - Valor Válido: [303]

Campo 05(TIPO) – Preenchimento: Tipo de endereço do cliente. Exemplos: Avenida, Rua, Praça, etc.

REGISTRO 403: ITENS DO PEDIDO

Registro obrigatório para discriminar os itens do pedido.

Nº	Campo	Descrição	Tipo	Tam	Dec	Obrig
01	REG	Texto fixo contendo “403”.	C	003	-	O
02	CODIGO_BARRA	Identificação do produto por meio de código de barras.	C	050	-	N
03	REFERENCIA	Identificação do produto por meio de referência.	C	050	-	N
04	DESCRICAO	Descrição do produto.	C	080	-	O
05	UNIDADE	Unidade do item.	C	004	-	O
06	NCM	Código NCM.	N	008	-	O
07	TEM_ST	Verificação de existência de ST no item.	C	001	-	O
08	ALQ_ICMS	Alíquota do ICMS.	N	-	02	O
09	ALQ_COFINS	Alíquota do COFINS.	N	-	02	O
10	ALQ_PIS	Alíquota do PIS.	N	-	02	O
11	QUANTIDADE	Quantidade do item.	N	-	02	O
12	VL_UNIT	Valor unitário do item.	N	-	02	O
13	PERC_DESC	Percentual de desconto do item.	N	-	02	O
14	PERC_ASC	Percentual de acréscimo do item.	N	-	02	O
15	CST_PIS	Código da situação tributária referente ao PIS	N	002	-	N
16	CST_COFINS	Código da situação tributária referente ao COFINS	N	002	-	N
17	CEST	Código Cest	N	007	-	N

Observações: Nível hierárquico – 2 Ocorrência - 1:N (um ou vários por registro 103)

Campo 01 (REG) - Valor Válido: [403]