Mudanças entre as edições de "API para listagem de dívidas elegíveis para negociação pelo portal de negociação"

(Criou página com 'A API para listagem de dívidas elegíveis para negociação via portal de negociação deve ser utilizada para retornar a lista de dívidas em aberto e não negociadas de um...')
 
 
Linha 26: Linha 26:
 
== Lista de retorno ==
 
== Lista de retorno ==
  
{
+
[
    '''id_contasareceber''': int,
+
    {
    '''id_credor''': int,
+
        '''id_contasareceber''': int,
    '''id_cliente''': int,
+
        '''id_credor''': int,
    '''codigo''': string,
+
        '''id_cliente''': int,
    '''nome_cliente''': string,
+
        '''codigo''': string,
    '''cpf_cnpj''': string,
+
        '''nome_cliente''': string,
    '''datavencto''': datetime,
+
        '''cpf_cnpj''': string,
    '''valor''': decimal,
+
        '''datavencto''': datetime,
    '''valor_atualizado''': decimal,
+
        '''valor''': decimal,
    '''descricao''': string,
+
        '''valor_atualizado''': decimal,
    '''obs''': string,
+
        '''descricao''': string,
    '''valor_cartorio''': decimal,
+
        '''obs''': string,
    '''contrato''': string,
+
        '''valor_cartorio''': decimal,
    '''unidade''': string,
+
        '''contrato''': string,
    '''competencia''': string,
+
        '''unidade''': string,
    '''nome_credor''': string,
+
        '''competencia''': string,
    '''cpf_cnpj_credor''': string
+
        '''nome_credor''': string,
}
+
        '''cpf_cnpj_credor''': string
 +
    }
 +
]
  
 
Seguem informações complementares sobre cada coluna da lista de retorno:
 
Seguem informações complementares sobre cada coluna da lista de retorno:

Edição atual tal como às 16h15min de 25 de março de 2021

A API para listagem de dívidas elegíveis para negociação via portal de negociação deve ser utilizada para retornar a lista de dívidas em aberto e não negociadas de um devedor que estão elegíveis para negociação via portal de negociação.


Endpoint: https://www.recuperador.com.br/api/v1PortalNegociacao/?id_credor=XXXX&cpf_cnpj=YYYY

Ação: GET

Formato: JSON

Autenticação: enviar o token da API no campo username da autenticação Basic Auth. Deixe o campo password em branco.


Parâmetros de entrada

{

   id_credor: int,
   cpf_cnpj: string

}

Seguem informações complementares sobre cada parâmetro de entrada:

  • ID do credor: aceita apenas valores inteiros e é obrigatório. Ele deve ser preenchido com o código do credor que aparece em Cadastros > Credores.
  • CPF/CNPJ do devedor: aceita no máximo de 18 caracteres e é obrigatório. Somente números preferencialmente.


Lista de retorno

[

   {
       id_contasareceber: int,
       id_credor: int,
       id_cliente: int,
       codigo: string,
       nome_cliente: string,
       cpf_cnpj: string,
       datavencto: datetime,
       valor: decimal,
       valor_atualizado: decimal,
       descricao: string,
       obs: string,
       valor_cartorio: decimal,
       contrato: string,
       unidade: string,
       competencia: string,
       nome_credor: string,
       cpf_cnpj_credor: string
   }

]

Seguem informações complementares sobre cada coluna da lista de retorno:

  • ID contas a receber: retornará um valor inteiro que representa o identificador da dívida no credor.
  • ID credor: retornará um inteiro que representa o código do credor.
  • ID cliente: retornará um inteiro que representa o código do cliente (devedor).
  • Codigo: retornará uma string que representa o código do dívida presente no sistema de gestão do credor, se houver.
  • Nome cliente: retornará uma string que representa o nome do cliente (devedor).
  • CPF/CNPJ: retornará uma string que representa o CPF ou CNPJ do devedor.
  • Data de vencimento: retornará uma string que representa a data de vencimento original da dívida. Ela estará no formato YYYY-MM-DDT00:00:00.
  • Valor: valor original (principal) da dívida. Campo no formato decimal e usa ponto como separador de decimais.
  • Valor atualizado: valor da dívida atualizado com juros, multa, correção monetária (se houver) e taxa de cartório (se houver). Campo no formato decimal e usa ponto como separador de decimais.
  • Descricao: retornará uma breve descrição sobre a dívida em formato string.
  • Obs: retornará observações complementares sobre a dívida em formato string, se houver.
  • Valor cartorio: valor da taxa de cartório da dívida, se houver. Campo no formato decimal e usa ponto como separador de decimais.
  • Contrato: retornará uma string com o código do contrato da dívida, se houver.
  • Unidade: retornará uma string com o número da unidade da dívida, se houver.
  • Competencia: retornará uma string com o mês e ano da competência da dívida, se houver.
  • Nome credor: retornará uma string com o nome do credor da dívida;
  • CPF/CNPJ credor: retornará uma string que representa o CPF ou CNPJ do credor da dívida;