# Integração de contas a receber
# Cadastrar nota
O cadastro de nota é utilizado para inserção se notas fiscais. Notas podem ter ou não títulos associados.
| Código | Descrição | Tipo | Tam. | Informações |
|---|---|---|---|---|
| @#N0 | Código da nota. | String | 30 | |
| @#N1 | Documento do cliente. | String | 15 | CNPJ, CPF ou Código identificador exportação. |
| @#N2 | Tipo pessoa do cliente | String | 1 | J - Jurídica F - Física E - Exportação |
| @#N3 | Nome da origem do cliente. | String | 40 | |
| @#N4 | Documento do representante | String | 15 | CNPJ, CPF ou Código identificador exportação. |
| @#N5 | Tipo pessoa do representante | String | 1 | J - Jurídica F - Física E - Exportação |
| @#N6 | Nome da origem do representante | String | 40 | |
| @#N7 | Data da emissão da nota | DateTime | Formato: dd/mm/aaaa | |
| @#N8 | Documento da nota | String | 30 | |
| @#N9 | Série | String | 10 | |
| @#NA | Situação | Int | 1 - Faturamento normal 2- Devolução 3- Cancelamento | |
| @#NB | Valor | Decimal | 18,2 | Símbolo decimal: ",". |
| @#NC | Status | Int | 1- Sim 2- Não | |
| @#ND | Documento do cliente cedente | String | 15 | CNPJ, CPF ou Código identificador exportação. |
| @#NE | Tipo do cliente cedente | String | 1 | J - Jurídica F - Física E - Exportação |
| @#NF | Nome da origem cedente | String | 40 |
Atenção
A chave de identificação de integração de nota é composta pelas informações do cliente ("@#N1", "@#N2" e "@#N3") e pelas informações da nota ("@#N0").
Observação
Caso não seja necessário o cadastra do cedente da nota, as identificações: @#ND, @#NE e @#NF não devem ser enviadas ou enviar sem a TAG sem informação.
Exemplo layout TXT
@#N0CDGNota0000@#N1123456789012345@#N2F@#N3OrigemNome@#N400342187775@#N5F@#N6Origem Representante@#N702/05/2017@#N8DOC_NOTA_TXT@#N91A@#NA1@#NB900000@#NC1@#ND13355555376@#NEF@#NFOrigem Cedente
# Cadastro cheque
O cadastro de cheque é utilizado no contas a receber. Pode ser relacionado com um ou mais parametrizações de categorias para cheques.
| Código | Descrição | Tipo | Tam. | Informações |
|---|---|---|---|---|
| @#C0 | Documento do cliente. | String | 15 | CNPJ, CPF ou Código identificador exportação. |
| @#C1 | Tipo pessoa do cliente | String | 1 | J - Jurídica F - Física E - Exportação |
| @#C2 | Nome da origem. | String | 40 | |
| @#C3 | Nome da parametrização categoria. | String | 100 | |
| @#C4 | Valor do cheque. | Decimal | 18,2 | Símbolo decimal: "," |
| @#C5 | Banco | String | 50 | |
| @#C6 | Agência | String | 20 | |
| @#C7 | Situação | Int | 1- Compensado 2- Devolvido 0- Não compensado | |
| @#C8 | Conta corrente | String | 15 | |
| @#C9 | CPF ou CNPJ | String | 14 | CNPJ ou CPF |
| @#CA | Data de emissão. | DateTime | Formato: dd/mm/aaaa | |
| @#CB | Data de vencimento. | DateTime | Formato: dd/mm/aaaa | |
| @#CC | Número: Número que não pode ser repetido pelo cliente, CMC7 ou código primário. | String | 40 | |
| @#CD | Documento do cliente cedente | String | 15 | CNPJ, CPF ou Código identificador exportação |
| @#CE | Tipo pessoa do cliente cedente. | String | 1 | J - Jurídica F - Física E - Exportação |
| @#CF | Nome da origem cedente | String | 40 | |
| @#CG | Número cheque: Número interno onde o cliente pode inserir alguma informação de controle interno. | String | 40 | |
| @#CH | Código do sistema de gestão da parametrização categoria | String | 50 | Não é obrigatório informar esse marcador |
Atenção
A chave de identificação de integração de cheque é composta pelas informações do cliente ("@#C0", "@#C1" e "@#C2") e pelas informações de cheque ("@#CC").
Exemplo layout TXT
@#C0123456789012345@#C1E@#C2Nome Origem@#C3CHEQUE@#C4400,00@#C5Santader@#C61198@#C71@#C866633965@#C912345678901234@#CA27/03/2017@#CB27/05/2017@#CCTXTTESTE2@#CD12345678901234@#CEF@#CForigem Cedente@#CG0011099@#CHCDGPRAM00222
# Cadastro nota complementar
O cadastro de nota complementar é utilizado para inserir notas de crédito e notas de débito. A nota complementar ainda pode ser associada a um título.
| Código | Descrição | Tipo | Tam. | Informações |
|---|---|---|---|---|
| Iniciar com @#InicioNotaComplementar | ||||
| @#N0 | Código da nota complementar | String | 30 | |
| @#N1 | Documento do cliente | String | 15 | CNPJ, CPF ou Código identificador exportação |
| @#N2 | Tipo pessoa do cliente | String | 1 | J - Jurídica F - Física E - Exportação |
| @#N3 | Nome da origem do cliente | String | 40 | |
| @#N4 | Código da nota | String | 30 | |
| @#N5 | Data da emissão da nota | DateTime | Formato: dd/mm/aaaa | |
| @#N6 | Documento da nota complementar | String | 30 | |
| @#N7 | Saldo | Decimal | 18,2 | Símbolo decimal: "," |
| @#N8 | Tipo da nota complementar. | Int | 1 - Crédito 2 - Débito | |
| @#N9 | Valor. | Decimal | 18,2 | Símbolo decimal: "," |
| @#NA | Documento do cliente cedente. | String | 15 | CNPJ, CPF ou Código identificador exportação. |
| @#NB | Tipo do cliente cedente. | String | 1 | J - Jurídica F - Física E - Exportação |
| @#NC | Nome da origem do cliente cedente | String | 40 |
Atenção
A chave de identificação de integração de nota complementar é composta pelas informações do cliente ("@#N1", "@#N2" e "@#N3") e pelas informações da nota complementar ("@#N0").
Exemplo layout TXT
@#InicioNotaComplementar@#N01234560123456@#N112345678901234@#N2F@#N3OrigemCliente@#N4CDGNOTA003@#N501/01/2017@#N6IntegraçãoTXT_02@#N71000,00@#N81@#N92000,00@#NA123456789012345@#NBJ@#NCOrigem Cedente
@#FimNotaComplementar
# Associar parametrização categoria
Atenção
Para cada associação de parametrização de categoria deve ser adicionada uma nova linha no arquivo de cadastro de nota complementar com a seguinte TAG: @#AssociarParametrizacaoCategoria.
Os marcadores @#P0 é obrigatório somente na associação de nota complementar com parametrização categoria. Para desassociar todas as parametrizações de categoria da nota complementar, deve-se informar o marcador sem nenhuma informação.
| Código | Descrição | Tipo | Tam. | Informações |
|---|---|---|---|---|
| @#P0 | Nome da parametrização categoria. | String | 100 |
Atenção
Finalizar o bloco de parametrização categoria com @#FimNotaComplementar
Exemplo layout TXT
@#InicioNotaComplementar@#N01234560123456@#N112345678901234@#N2F@#N3Origem Cliente@#N4CDGNOTA003@#N501/01/2017@#N6IntegraçãoTXT_02@#N71000,00@#N81@#N92000,00@#NA123456789012345@#NBJ@#NCOrigem Cedente
@#AssociarParametrizacaoCategoria@#P0NomeParametrizacaoCategoria
@#FimNotaComplementar
# Cadastrar título
Além da funcionalidade de cadastrar títulos é possível realizar as seguintes associações:
- Associar título com nota fiscal.
- Associar título com cheque.
- Associar título com nota complementar.
- Associar e desassociar título com parametrização de categoria.
Atenção
As informações de Codigo do título, Documento do título e Número do boleto podem ser utilizadas no processo de negativação Serasa, para envio no campo NossoNumero da remessa, caso sejam selecionados no momento da negativação. Para utilização com sucesso dessas informações, o valor selecionado deve seguir as exigências da Serasa, sendo composto somente de números e ter no máximo 9 dígitos. Obs.: Caracteres especiais e espaços são removidos pelo sistema no momento da geração da remessa.
Negativação Serasa, Negativação Boa Vista, Protesto Nacional, Protesto São Paulo e Escritórios de Cobrança são funcionalidades que utilizam diretamente de várias informações dos títulos, portanto caso o cliente venha utilizar um desses processos, integração deve ser pensada e realizada de maneira a fornecer dados formatados para não gerar nenhum problema nestes processos.
| Código | Descrição | Tipo | Tam. | Informações |
|---|---|---|---|---|
| Iniciar com @#InicioTitulo | ||||
| @#T0 | Código do título. | String | 30 | |
| @#T1 | Documento do cliente. | String | 15 | CNPJ, CPF ou Código identificador exportação. |
| @#T2 | Tipo pessoa do cliente. | String | 1 | J - Jurídica F - Física E - Exportação |
| @#T3 | Nome da origem do cliente. | String | 40 | |
| @#T4 | Documento do representante. | String | 15 | CNPJ, CPF ou Código identificador exportação. |
| @#T5 | Tipo pessoa do representante. | String | 1 | J - Jurídica F - Física E - Exportação |
| @#T6 | Nome da origem do representante. | String | 40 | |
| @#T7 | Documento do título. | String | 30 | Este campo é utilizado como agrupador de títulos, quando for realizado parcelamento de uma compra, e cada parcela for integrada como um título. Valores de data/valor da última/maior compra podem ser diretamente impactados por esse campo. |
| @#T8 | Data de emissão. | DateTime | Formato: dd/mm/aaaa | |
| @#T9 | Data de vencimento prorrogado. | DateTime | Formato: dd/mm/aaaa | |
| @#TA | Data de vencimento. | DateTime | Formato: dd/mm/aaaa | |
| @#TB | Motivo prorrogação. | Int | 1 - Considera para o cálculo a data de vencimento original. 2 - Considera para o cálculo a data de vencimento prorrogado. | |
| @#TC | Observação. | String | 150 | |
| @#TD | Parcela. | String | 10 | |
| @#TE | Valor. | Decimal | 18,2 | Símbolo decimal: "," |
| @#TF | Documento do cliente cedente. | String | 15 | CNPJ, CPF ou Código identificador exportação. Obs.: Caso o cliente não for cedente no arquivo TXT deve ser informado só o identificador desse campo sem nenhuma informação. |
| @#TG | Tipo pessoa do cliente cedente. | String | 1 | J - Jurídica F - Física E - Exportação Obs.: Caso o cliente não for cedente no arquivo TXT deve ser informado só o identificador desse campo sem nenhuma informação. |
| @#TH | Nome da origem do cliente cedente. | String | 40 | Obs.: Caso o cliente não for cedente no arquivo TXT deve ser informado só o identificador desse campo sem nenhuma informação. |
| @#TI | Número do boleto do título. | String | 100 |
Atenção
A chave de identificação de integração de título é composta pelas informações do cliente ("@#T1", "@#T2" e "@#T3") e pelas informações do título ("@#T0").
Exemplo layout TXT
@#InicioTitulo@#T0CDG0032323@#T1123456789012345@#T2J@#T3OrigemCLiente@#T4123456789012345@#T5J@#T6Origem Representante@#T7DOCTITULO131313@#T824/01/2017@#T907/02/2017@#TA03/02/2017@#TB1@#TCSem observação!@#TD1@#TE1000,00@#TF123456884544@#TGF@#THOrigem Cedente@#TI050505
@#FimTitulo
# Associar parametrização categoria
Atenção
Para cada associação de parametrização de categoria deve ser adicionada uma nova linha no arquivo de cadastro de título com a seguinte TAG: @#AssociarParametrizacaoCategoria.
Os marcadores @#P0 e @#P1 são obrigatórios somente na associação de título com parametrização categoria. Para desassociar todas as parametrizações de categoria do título, deve-se informar os marcadores sem nenhuma informação.
Para associação de parametrização de categoria deve ser sempre informado o código sistema gestão da parametrização, marcador "@#P1". Não será realizado a associação através do nome da parametrização.
| Código | Descrição | Tipo | Tam. | Informações |
|---|---|---|---|---|
| @#P0 | Nome da parametrização categoria. | String | 100 | |
| @#P1 | Código sistema de gestão da parametrização de categoria. | String | 50 |
Exemplo layout TXT
@#InicioTitulo@#T0INTMG001@#T156566565345@#T2J@#T3Sistema de Gestao@#T413456123456@#T5F@#T6OrigemRepresentante@#T7565601@#T801/01/2020@#T907/02/2020@#TA03/02/2020@#TB1@#TCObservacao@#TDooINTMG001@#TE1500,00@#TF2222323255@#TGF@#THORIGEM CEDENTE@#TI101010
@#AssociarParametrizacaoCategoria@#P0@#P1RGTCI001
@#FimTitulo
# Associar cheque
Atenção
Para cada associação de cheque deve ser adicionada uma nova linha no arquivo de cadastro de título com a seguinte TAG: @#AssociarCheque.
| Código | Descrição | Tipo | Tam. | Informações |
|---|---|---|---|---|
| @#C0 | Número do cheque. | String | 40 | |
| @#C1 | Documento do cliente. | String | 15 | CNPJ, CPF ou Código identificador exportação. |
| @#C2 | Tipo pessoa do cliente | String | 1 | J - Jurídica F - Física E - Exportação |
| @#C3 | Nome da origem. | String | 40 | |
| @#C4 | Valor utilizado. | Decimal | 18,2 | Símbolo decimal: "," |
Exemplo layout TXT
@#InicioTitulo@#T0999565645@#T16690127925@#T2F@#T3SistemadeGestão@#T449033004000165@#T5J@#T6SistemadeGestão@#T7666565665@#T824/01/2017@#T907/02/2017@#TA03/02/2017@#TB1@#TCSem observação!@#TD1A@#TE1000,00@#TF@#TG@#THORIGEM CEDENTE@#TI101010
@#AssociarCheque@#C00000323232@#C1455545454@#C2F@#C3Origem Nome@#C4100,00
@#FimTitulo
# Associar nota
Atenção
Para cada associação de nota deve ser adicionada uma nova linha no arquivo de cadastro de título com a seguinte TAG: @#AssociarNota.
| Código | Descrição | Tipo | Tam. | Informações |
|---|---|---|---|---|
| @#N0 | Código da nota. | String | 30 | |
| @#N1 | Documento do cliente. | String | 15 | CNPJ, CPF ou Código identificador exportação. |
| @#N2 | Tipo pessoa do cliente. | String | 1 | J - Jurídica F - Física E - Exportação |
| @#N3 | Nome da origem. | String | 40 |
Exemplo layout TXT
@#InicioTitulo@#T0999565645@#T16690127925@#T2F@#T3SistemadeGestão@#T449033004000165@#T5J@#T6SistemadeGestão@#T7666565665@#T824/01/2017@#T907/02/2017@#TA03/02/2017@#TB1@#TCSem observação!@#TD1A@#TE1000,00@#TF@#TG@#THORIGEM CEDENTE@#TI101010
@#AssociarNota@#N0@#N109090127925@#N2F@#N3Sistema de Gestão
@#FimTitulo
# Associar nota complementar
Atenção
Para cada associação de nota complementar deve ser adicionada uma nova linha no arquivo de cadastro de título com a seguinte TAG: @#AssociarNComplementar.
| Código | Descrição | Tipo | Tam. | Informações |
|---|---|---|---|---|
| @#M0 | Código da nota complementar. | String | 30 | |
| @#M1 | Documento do cliente. | String | 15 | CNPJ, CPF ou Código identificador exportação. |
| @#M2 | Tipo pessoa do cliente. | String | 1 | J - Jurídica F - Física E - Exportação |
| @#M3 | Nome da origem. | String | 40 |
Atenção
Finalizar o bloco de parametrização categoria com @#FimTitulo
Exemplo layout TXT
@#InicioTitulo@#T0999565645@#T16690127925@#T2F@#T3Sistema de Gestão@#T449033004000165@#T5J@#T6Sistema de Gestão@#T7666565665@#T824/01/2017@#T907/02/2017@#TA03/02/2017@#TB1@#TCSem observação!@#TD1A@#TE1000,00@#TF@#TG@#THORIGEM CEDENTE@#TI101010
@#AssociarNComplementar@#M0@#M105578580971@#M2F@#M3Sistema de Gestão
@#FimTitulo
# Cadastro movimento geral
O cadastro de movimento geral é utilizado para dar movimentações em títulos. O tipo de movimento geral já deve ser cadastrado antes de executar esse serviço.
| Código | Descrição | Tipo | Tam. | Informações |
|---|---|---|---|---|
| @#M0 | Código do título. | String | 30 | |
| @#M1 | Documento do cliente. | String | 15 | CNPJ, CPF ou Código identificador exportação. |
| @#M2 | Tipo pessoa do cliente. | String | 1 | J - Jurídica F - Física E - Exportação |
| @#M3 | Nome da origem. | String | 40 | |
| @#M4 | Nome do tipo de movimentação. | String | 50 | |
| @#M5 | Documento da movimentação. | String | 30 | |
| @#M6 | Data da movimentação. | DateTime | Formato: dd/mm/aaaa | |
| @#M7 | Valor da movimentação. | Decimal | 18,2 | Símbolo decimal: "," |
| @#M8 | Código sistema gestão do tipo de movimentação. | String | 50 |
Atenção
A chave de identificação de movimentação geral é composta pelas informações do tipo de movimentação geral ("@#M8" ou "@#M4"), pelas informações do título ("@#M0") e pelas informações do cliente ("@#M1", "@#M2" e "@#M3").
Exemplo layout TXT
@#M0CDGTITULO021212@#M1123456789012345@#M2J@#M3Sistema de Gestao@#M4@#M5DOCMOVIM0303@#M613/02/2017@#M7300,00@#M8
# Cadastro movimento baixa
O cadastro de movimento de baixas é utilizado para dar baixa em títulos. O tipo de movimento de baixa já deve ser cadastrado antes de executar esse serviço.
| Código | Descrição | Tipo | Tam. | Informações |
|---|---|---|---|---|
| @#M0 | Código do título. | String | 30 | |
| @#M1 | Documento do cliente. | String | 15 | CNPJ, CPF ou Código identificador exportação. |
| @#M2 | Tipo pessoa do cliente. | String | 1 | J - Jurídica F - Física E - Exportação |
| @#M3 | Nome da origem. | String | 40 | |
| @#M4 | Nome do tipo de baixa. | String | 50 | |
| @#M5 | Documento da baixa. | String | 30 | |
| @#M6 | Data da baixa. | DateTime | Formato: dd/mm/aaaa | |
| @#M7 | Valor da baixa. | Decimal | 18,2 | Símbolo decimal: "," |
| @#M8 | Código sistema gestão do tipo de baixa. | String | 50 |
Atenção
A chave de identificação de associação de movimentação baixa é composta pelas informações do tipo de movimentação baixa ("@#M8" ou "@#M4"), pelas informações do título ("@#M0") e pelas informações do cliente ("@#M1", "@#M2" e "@#M3").
Exemplo layout TXT
@#M0CODGTIT0505@#M1123456789012345@#M2J@#M3Sistema de Gestão@#M4BAIXA@#M5DocBaixaTXT_006E@#M613/02/2017@#M7300,00@#M8CDG0202BAIXA
# Cadastro parametrização categoria
| Código | Descrição | Tipo | Tam. | Informações |
|---|---|---|---|---|
| @#P0 | Código da categoria. | Int | Código interno da categoria no DepsNet - desconsiderar. | |
| @#P1 | Nome da parametrização categoria. | String | 100 | Nome da parametrização categoria. |
| @#P2 | Código sistema de gestão da parametrização categoria. | String | 50 | |
| @#P3 | Conta inadimplência. | Int | 0 - Não conta inadimplência 1 - Conta Inadimplência. | |
| @#P4 | Conta pagamento. | Int | 0 - Não conta pagamento 1 - Conta pagamento. | |
| @#P5 | Tipo relacionamento. | Int | 1 - Título 2 - Cheque 3 - Nota complementar | |
| @#P6 | Nome da categoria. | String | 30 | É necessário cadastrar a categoria através do DepsNet para integrar as parametrizações de categorias. |
| @#P7 | Reservado para uso da DEPS. | Informar campo vazio. Ex: @#P7 | ||
| @#P8 | Reservado para uso da DEPS. | Informar campo vazio. Ex: @#P8 | ||
| @#P9 | Reservado para uso da DEPS. | Informar campo vazio. Ex: @#P9 |
Atenção
Os campos "@#P2", "@#P5" e "@#P1" compõem a chave de identificação da integração de parametrização categoria.
Observação
As informações dos campos "@#P3", "@#P4", "@#P5" e "@#P6" são somente inseridas ao cadastrar uma parametrização de categoria, ou seja, caso essas informações sejam alteradas quando a parametrização já estiver cadastrada no DepsNet, não é possível realizar a atualização dessas informações. Somente pelo DepsNet.
Exemplo layout TXT
@#P0CDG88888@#P1Parametrização Categoria Título@#P2CDGPARAMETRIZACAO212121@#P31@#P41@#P51@#P6Portador@#P7J@#P8@#P9
# Desassociar parametrização categoria título cliente
Desassocia uma ou mais parametrização categoria do título e cliente informado.
| Código | Campo | Tipo | Tam. | Informações |
|---|---|---|---|---|
| @#P0 | Documento. | String | 15 | CNPJ, CPF ou Código identificador exportação. |
| @#P1 | Nome da origem. | String | 40 | |
| @#P2 | Tipo pessoa do cliente. | String | 1 | J - Jurídica F - Física E - Exportação |
| @#P3 | Código do título | String | 30 | |
| @#P4 | Código do sistema de gestão da parametrização categoria. | String | 50 | Não obrigatório. Caso seja informado, remove apenas a parametrização categoria informada. |
| @#P5 | Nome da categoria de parametrização categoria. | String | 40 | Não obrigatório. Caso seja informado, irá remover apenas as parametrizações de categoria da categoria informada. |
Atenção
A chave de identificação de desassociação parametrização categoria título cliente é composta pelas informações da parametrização categoria ("@#P5" ou "@#P4"), pelas informações do título ("@#P3") e pelas informações do cliente ("@#P0", "@#P1" e "@#P2").
Exemplo layout TXT
@#P0123456789012345@#P1Sistema de Gestão@#P2E@#P3CDGTIT444@#P4CODGPRMT020202@#P5Portador
# Desassociar parametrização categoria nota comp. cliente
Desassocia uma ou mais parametrização categoria da nota complementar e cliente informado.
| Código | Descrição | Tipo | Tam. | Informações |
|---|---|---|---|---|
| @#N0 | Documento. | String | 15 | CNPJ, CPF ou Código identificador exportação. |
| @#N1 | Nome da origem. | String | 40 | |
| @#N2 | Tipo pessoa do cliente. | String | 1 | J - Jurídica F - Física E - Exportação |
| @#N3 | Código da nota complementar | String | 30 | |
| @#N4 | Código do sistema de gestão da parametrização categoria. | String | 50 | Não obrigatório. Caso seja informado, remove apenas a parametrização categoria informada. |
| @#N5 | Nome da categoria de parametrização categoria. | String | 40 | Não obrigatório. Caso seja informado, irá remover apenas as parametrizações de categoria da categoria informada. |
Atenção
A chave de identificação de desassociação parametrização categoria nota complementar é composta pelas informações da parametrização categoria ("@#N4" ou "@#N5") e pelas informações da nota complementar ("@#N3").
Exemplo layout TXT
!novo
@#N011234566678@#N1NOME ORIGEM@#N2J@#N3CDGNOTA44545@#N4CDGsgPARMT0004@#N5CATEGORIAPRMT