...
Existe a necessidade de criar uma documentação sobre o layout do arquivo que será usado para importação de históricos
03. SOLUÇÃO
O layout de importação será o mesmo de exportação, e será o seguinte:
O primeiro campo de cada linha será uma string, com valores pré-estabelecidos, e que servem para identificar o tipo de linha.
Os valores possíveis são:
H: Linha com as informações de topo do histórico
C: Linha com as informações das partidas do histórico, tanto as partidas fiscais quanto as gerenciais
P: Linha com as informações dos parâmetros das partidas do histórico
E: Linha com as informações das empresas em que o histórico é aceito
M: Linha com as informações dos módulos em que o histórico é aceito
Linhas do tipo H:
| Obrigatório | Quantidade Min. | Quantidade Max. | Layout |
|---|
| Sim | 1 | 1 | H|seqhistorico|codreduzido|descricao| |
rateiorateiodinamico| seqrateiodinamico|lancamentoperiodico |
Campos:
| Campo | Descrição | Obrigatório | Valor | Tamanho máximo | Observações |
|---|
| seqhistorico | Identificador do Histórico |
Não| Sim | Numérico | 15 caracteres | Se for informado |
0 ou vazio| um número negativo, será tratado como um novo histórico a ser adicionado. Caso |
contrário| seja um número positivo, irá atualizar o histórico já existente que correspondente ao identificador informado. |
| codreduzido | Código reduzido do Histórico | Sim | String | 20 caracteres | Deve ser único entre todos os históricos |
| descricao | Descrição do Rateio | Sim | String | 50 caracteres |
rateio
|
| tiporateio | Indicador do tipo de Rateio | Sim | [S,N,D] | 1 caractere | S: Rateio Manual; N: Sem Rateio; D: Rateio Dinâmico |
rateiodinamicoDescrição | Identificador do Rateio Dinâmico usado | Não | String | 100 caracteres | Caso |
rateio| tiporateio = D, então deve ser informado, caso contrario, deve deixar vazio |
| lancamentoperiodico | Indicador se histórico é usado em Lançamento Periódico | Sim | [S,N] | 1 caractere | S: Sim; N: Não |
Linhas do tipo C:
| Obrigatório | Quantidade Min. | Quantidade Max. | Layout |
|---|
| Sim | 2 | N | C|seqhistorico|seqhistoricoconta|conta| |
tipo| tipopartida|historicocompleto|porcentagem|ordem|contabsped|criterio|gerencial |
Campos:
| Campo | Descrição | Obrigatório | Valor | Tamanho máximo | Observações |
|---|
| seqhistorico | Identificador do Histórico | Sim | Numérico | 15 caracteres | Identifica o histórico da qual a partida faz parte |
| seqhistoricoconta | Identificador da partida | Sim | Numérico | 15 caracteres | Se for informado um |
valor | número negativo, será tratado como uma nova partida a ser adicionada. Caso |
contrário| seja um número positivo, irá atualizar a partida já existente correspondente ao identificador informado. |
| conta | Conta da partida | Sim | Numérico | 50 caracteres | Apenas valores numéricos, sem máscara. |
tipo| tipopartida | Indicador do tipo da partida | Sim | [C,D] | 1 caractere | C: Crédito; D: Débito. Para cada histórico, deve haver pelo menos uma linha de Débito e uma de Crédito. |
| historicocompleto | Histórico completo da partida | Não | String | 2000 caracteres |
|
| porcentagem | Valor da porcentagem de rateio da partida |
Não-| 0 a 100 | Só deve ser preenchido caso |
rateio. A | e se esse for o caso, a soma das porcentagens das partidas de um mesmo tipo ( |
C,D| Crédito ou Débito) deve ser |
sempre | igual a 100. Caso contrário, preencher com valor 0. |
| ordem | Ordem da partida | Não | Numérico | 6 caracteres |
|
| contabsped | Indicador se contabiliza SPED |
NãoSe não informado, tomará como valor padrão N |
|
| criterio | Descrição do critério | Não | String | 200 caracteres | Só deve ser informado caso rateio=D |
| gerencial | Indicador Gerencial da partida | Sim | [F,G] | 1 caractere | F = Fiscal; G = Gerencial |
Linhas do tipo P:
| Obrigatório | Quantidade Min. | Quantidade Max. | Layout |
|---|
| N | 0 | N | P|seqhistoricoconta|seqhistoricocontaparam|parametro|parametrovalor|nivel|porcentagem|seqhistoricocontaparampai|ordem |
Campos:
| Campo | Descrição | Obrigatório | Valor | Tamanho máximo | Observações |
|---|
| seqhistoricoconta | Identificador da partida | Sim | Numérico | 15 caracteres | Identifica a partida da qual o parâmetro faz parte |
| seqhistoricocontaparam | Identificador do parâmetro da partida | Sim | Numérico | 15 caracteres | Se for informado um valor negativo, será tratado como um novo parâmetro a ser adicionado. Caso contrário, irá atualizar o parâmetro já existente correspondente ao identificador informado. |
| parametro | Indicador do tipo de parâmetro | Sim | [U,PE,T,CX,E,BC] | 2 caractere | U: Grupo Contábil; PE: Pessoa; T: Centro de Resultado; CX: Caixa; E: Empresa; BC: Banco |
| parametrovalor | Valor do Parâmetro | Sim | String | 20 caracteres |
|
| nivel | Nível do Parâmetro | Sim | Numérico | 6 caracteres |
|
| porcentagem | Valor da porcentagem de rateio do parâmetro | Não | Numérico | - | Só deve ser preenchido caso rateio=S ou rateio=D. Caso rateio=D, a soma das porcentagens de um mesmo nível e de um mesmo pai deve ser 100 (Para representar 100% do valor da porcentagem da partida ou do parâmetro pai. Caso rateio=S, a soma das porcentagens de um mesmo nível e de um mesmo pai deve ser igual ao valor de porcentagem desse pai (seja partida ou parâmetro pai) |
| seqhistoricocontaparampai | Identificador do parâmetro pai | Não | Numérico | 15 caracteres | Obrigatório ser preenchido caso nível >= 2 |
| ordem | Ordem do parâmetro | Não | Numérico | 6 caracteres |
|
Linhas do tipo E:
| Obrigatório | Quantidade Min. | Quantidade Max. | Layout |
|---|
| Sim | 1 | N | E|seqhistorico|nroempresa|situacao |
Campos:
| Campo | Descrição | Obrigatório | Valor | Tamanho máximo | Observações |
|---|
| seqhistorico | Identificador do Histórico | Sim | Numérico | 15 caracteres | Identifica o histórico da qual a configuração faz parte |
| nroempresa | Número da Empresa | Sim | Numérico | 6 caracteres |
|
| situacao | Indicador do status do histórico para aquela empresa | Sim | [A,I] | 1 caractere | A: Ativo; I: Inativo |
Linhas do tipo M:
| Obrigatório | Quantidade Min. | Quantidade Max. | Layout |
|---|
| Sim | 1 | N | E|seqhistorico|siglamodulo|situacao |
Campos:
| Campo | Descrição | Obrigatório | Valor | Tamanho máximo | Observações |
|---|
| seqhistorico | Identificador do Histórico | Sim | Numérico | 15 caracteres | Identifica o histórico da qual a configuração faz parte |
| siglamodulo | Sigla do módulo | Sim | String | 5 caracteres |
|
| situacao | Indicador do status do histórico para aquele módulo | Sim | [A,I] | 1 caractere | A: Ativo; I: Inativo |
04. DEMAIS INFORMAÇÕES
Disponível a partir da versão 24.07.
...