Valores aceitáveis para o campo "Especie" do título

[DeveloperATS]

Bom dia;

A documentação do ACBr não aparenta listar os valores possíveis para o parâmetro "Especie" do título:

https://acbr.sourceforge.io/ACBrLib/ConfiguracoesdaBiblioteca3.html
 

A primeira reação quanto a isso é, naturalmente, utilizar o próprio código de espécie usado pelo banco, mas isso não funciona, pois o ACBr utiliza os seus próprios valores, ao invés de repassar o valor normal do banco:

 

     { Pegando o tipo de EspecieDoc }
     if EspecieDoc = 'DM' then
       ATipoEspecieDoc   := '01'
     else if EspecieDoc = 'NP' then
       ATipoEspecieDoc   := '02'
     else if EspecieDoc = 'NS' then
       ATipoEspecieDoc   := '03'
     else if EspecieDoc = 'RC' then
       ATipoEspecieDoc   := '05'
     else if EspecieDoc = 'LC' then
       ATipoEspecieDoc   := '08'
     else if EspecieDoc = 'DS' then
       ATipoEspecieDoc   := '12'
     else if EspecieDoc = 'ND' then
       ATipoEspecieDoc   := '13';

O exemplo acima é do CNAB400 do BB.

Existe algum lugar onde estejam documentados quais são os valores de EspecieDoc que o ACBr aceita, e o que cada um deles significa?
Existe algum lugar onde estejam documentados quais valores de EspecieDoc são mapeados para cada tipo de documento em cada banco?

Exemplo: para o CNAB400 do BB:

EspecieDoc	ATipoEspecieDoc
DM	1
NP	2
NS	3
RC	5
LC	8
DS	12
ND	13

[antonio.carlos]

Tópico movido para a área do SAC, para que o SLA de respostas seja considerado

[Victor H. Gonzales - Panda]

1 hora atrás, DeveloperATS disse:

Bom dia;

A documentação do ACBr não aparenta listar os valores possíveis para o parâmetro "Especie" do título:

https://acbr.sourceforge.io/ACBrLib/ConfiguracoesdaBiblioteca3.html
 

A primeira reação quanto a isso é, naturalmente, utilizar o próprio código de espécie usado pelo banco, mas isso não funciona, pois o ACBr utiliza os seus próprios valores, ao invés de repassar o valor normal do banco:

 

     { Pegando o tipo de EspecieDoc }
     if EspecieDoc = 'DM' then
       ATipoEspecieDoc   := '01'
     else if EspecieDoc = 'NP' then
       ATipoEspecieDoc   := '02'
     else if EspecieDoc = 'NS' then
       ATipoEspecieDoc   := '03'
     else if EspecieDoc = 'RC' then
       ATipoEspecieDoc   := '05'
     else if EspecieDoc = 'LC' then
       ATipoEspecieDoc   := '08'
     else if EspecieDoc = 'DS' then
       ATipoEspecieDoc   := '12'
     else if EspecieDoc = 'ND' then
       ATipoEspecieDoc   := '13';

O exemplo acima é do CNAB400 do BB.

Existe algum lugar onde estejam documentados quais são os valores de EspecieDoc que o ACBr aceita, e o que cada um deles significa?
Existe algum lugar onde estejam documentados quais valores de EspecieDoc são mapeados para cada tipo de documento em cada banco?

Exemplo: para o CNAB400 do BB:

EspecieDoc	ATipoEspecieDoc
DM	1
NP	2
NS	3
RC	5
LC	8
DS	12
ND	13

Bom dia, não existe uma tabela de correlação.

esses índices variam de banco a banco, geralmente é inserido a sigla, e na geração é feito a conversão conforme solicitado no leiaute

as siglas geralmente são

{DM - DUPLICATA MERCANTIL}
{DS - DUPLICATA DE SERVICO}
{NP - NOTA PROMISSORIA}
{NR - NOTA PROMISSORIA RURAL}
{RC - RECIBO}
{AP – APOLICE DE SEGURO}
{CH - CHEQUE}
{ND - NOTA PROMISSORIA DIRETA}

[DeveloperATS]

OK, muito obrigado pela informação.

É uma pena que não haja documentação para isso.

Editado 30 Agosto, 2022 por DeveloperATS

[DeveloperATS]

Caso alguém precise, essas são as espécies usadas para o banco Santander (baseado na lógica em ACBrBancoSantander.pas):

Layout	Espécie	Descrição	Resultado
CNAB240	DM	DUPLICATA MERCANTIL	02
	DS	DUPLICATA DE SERVICO	04
	NP	NOTA PROMISSORIA	12
	NR	NOTA PROMISSORIA RURAL	13
	RC	RECIBO	17
	AP	APOLICE DE SEGURO	20
	CH	CHEQUE	97
	ND	NOTA PROMISSORIA DIRETA	98
	02, 04, 12, 13, 17, 20, 97 ou 98		Mesmo código
	Qualquer outro valor		Dá o erro 'Espécie de documento informada incorretamente!'
CNAB400	DM	DUPLICATA MERCANTIL	01
	NP	NOTA PROMISSORIA	02
	NS		03
	RC	RECIBO	05
	DS	DUPLICATA DE SERVICO	06
	LC		07
	BDP		08
	BCC		19
	Qualquer outro valor		Mesmo código

[Victor H. Gonzales - Panda]

15 horas atrás, DeveloperATS disse:

Caso alguém precise, essas são as espécies usadas para o banco Santander (baseado na lógica em ACBrBancoSantander.pas):

Layout	Espécie	Descrição	Resultado
CNAB240	DM	DUPLICATA MERCANTIL	02
	DS	DUPLICATA DE SERVICO	04
	NP	NOTA PROMISSORIA	12
	NR	NOTA PROMISSORIA RURAL	13
	RC	RECIBO	17
	AP	APOLICE DE SEGURO	20
	CH	CHEQUE	97
	ND	NOTA PROMISSORIA DIRETA	98
	02, 04, 12, 13, 17, 20, 97 ou 98		Mesmo código
	Qualquer outro valor		Dá o erro 'Espécie de documento informada incorretamente!'
CNAB400	DM	DUPLICATA MERCANTIL	01
	NP	NOTA PROMISSORIA	02
	NS		03
	RC	RECIBO	05
	DS	DUPLICATA DE SERVICO	06
	LC		07
	BDP		08
	BCC		19
	Qualquer outro valor		Mesmo código

Bom dia,

mas esses indices podem variar de banco a banco, não necessariamente o DM é 02 em outro banco, podem ser 01 ou até mesmo DM, por isso as classes fazem as conversões.

como nesse exemplo seu a discrepância do DM entre o CNAB240 e CNAB400 no no DM.

o que você está precisando fazer, exemplifique melhor a sua necessidade?

[DeveloperATS]

Em 31/08/2022 at 08:19, Victor H. Gonzales - Panda disse:

Bom dia,

mas esses indices podem variar de banco a banco, não necessariamente o DM é 02 em outro banco, podem ser 01 ou até mesmo DM, por isso as classes fazem as conversões.

como nesse exemplo seu a discrepância do DM entre o CNAB240 e CNAB400 no no DM.

o que você está precisando fazer, exemplifique melhor a sua necessidade?

Sim, está claro que essas regras vão variar de um banco para outro, de CNAB240 para CNAB400 e que o ACBr ainda joga umas regras deles no meio.

Inclusive, no caso do Santander é menos pior, porque se você informar os códigos oficiais do banco, ele aceita esses códigos. No caso do CNAB400 do Banco do Brasil é bem pior, pois ele não aceita os códigos fornecidos pelo banco: tem que informar os códigos do ACBr, para que eles produzam os códigos correspondentes do BB.

O problema principal é que não existe nada documentado que diga quais são essas peculiaridades, quais são os códigos que o ACBr aceita e no que é que eles se transformam; foi necessário consultar os fontes para saber qual código gera o que, para saber o que informar.

[Victor H. Gonzales - Panda]

Em 13/09/2022 at 09:07, DeveloperATS disse:

Sim, está claro que essas regras vão variar de um banco para outro, de CNAB240 para CNAB400 e que o ACBr ainda joga umas regras deles no meio.

Inclusive, no caso do Santander é menos pior, porque se você informar os códigos oficiais do banco, ele aceita esses códigos. No caso do CNAB400 do Banco do Brasil é bem pior, pois ele não aceita os códigos fornecidos pelo banco: tem que informar os códigos do ACBr, para que eles produzam os códigos correspondentes do BB.

O problema principal é que não existe nada documentado que diga quais são essas peculiaridades, quais são os códigos que o ACBr aceita e no que é que eles se transformam; foi necessário consultar os fontes para saber qual código gera o que, para saber o que informar.

Boa noite,

mas nesse caso, ao informar o DM o componente não está convertendo para 01 ou 02 corretamente ?

ou você tem alguma sugestão para o caso em que podemos melhorar o componente ?

[DeveloperATS]

Em 13/01/2023 at 19:55, Victor H. Gonzales - Panda disse:

Boa noite,

mas nesse caso, ao informar o DM o componente não está convertendo para 01 ou 02 corretamente ?

ou você tem alguma sugestão para o caso em que podemos melhorar o componente ?

O maior problema, no caso, é a inconsistência aliada à falta de documentação. Para algumas combinações de banco/formato de arquivo, a biblioteca aceita que você informe os mesmos códigos de que o banco de destino usa. Outros não aceitam que sejam informados os mesmos códigos de usados pelo banco, obrigando você a ter que usar os códigos de espécie específicos da ACBr, sendo que não há nenhuma documentação que diga quais espécies internas da ACBr correspondem a quais espécies do banco.

[Victor H. Gonzales - Panda]

Boa noite,

A ideia é numeradores, se tem algum banco talvez falta tratamento.

Pois na ficha de pagamento não deveria sair 02 e sim DM e na remessa 02, que me recordo a maioria dos bancos são assim, não posso dizer de todos.

Mas podemos aceitar algum sugestão para melhorar essa situação