Listar Contas a Receber

Retorna uma lista de contas a receber com base nos filtros aplicados.

Endpoint

GET /contas-receber

Parâmetros de Query

Parâmetro	Tipo	Descrição
data_previsao_de	string (YYYY-MM-DD)	Data inicial de previsão
data_previsao_ate	string (YYYY-MM-DD)	Data final de previsão
data_vencimento_de	string (YYYY-MM-DD)	Data inicial de vencimento
data_vencimento_ate	string (YYYY-MM-DD)	Data final de vencimento
status_titulo	string	Status do título (CANCELADO | PAGO | LIQUIDADO | EM ABERTO | PAGTO_PARCIAL | VENCE HOJE | A VENCER | ATRASADO)

Resposta

{
   "success": true,
   "data": [
      {
         "codigo_lancamento_omie": number,
         "codigo_lancamento_integracao": string,
         "codigo_cliente_fornecedor": string,
         "codigo_cliente_fornecedor_integracao": string,
         "data_vencimento": string,
         "valor_documento": number,
         "codigo_categoria": string,
         "data_previsao": string,
         "categorias": [
            {
               "codigo_categoria": string,
               "percentual": number,
               "valor": number
            }
         ],
         "id_conta_corrente": number,
         "numero_documento": string,
         "numero_parcela": string,
         "codigo_tipo_documento": string,
         "numero_documento_fiscal": string,
         "numero_pedido": string,
         "chave_nfe": string,
         "observacao": string,
         "codigo_barras_ficha_compensacao": string,
         "codigo_cmc7_cheque": string,
         "data_emissao": string,
         "id_origem": string,
         "operacao": string,
         "valor_pis": number,
         "retem_pis": string,
         "valor_cofins": number,
         "retem_cofins": string,
         "valor_csll": number,
         "retem_csll": string,
         "valor_ir": number,
         "retem_ir": string,
         "valor_iss": number,
         "retem_iss": string,
         "valor_inss": number,
         "retem_inss": string,
         "bloqueado": string,
         "bloquear_baixa": string,
         "importado_api": string,
         "baixar_documento": string,
         "conciliar_documento": string,
         "acao": string,
         "lancamento_detalhe": any[],
         "distribuicao": [
            {
               "cCodDep": string,
               "cDesDep": string,
               "nPerDep": number,
               "nValDep": number
            }
         ],
         "status_titulo": string,
         "codigo_vendedor": number,
         "codigo_projeto": number,
         "nsu": string,
         "data_registro": string,
         "tipo_agrupamento": string,
         "info": {
            "cImpAPI": string,
            "dAlt": string,
            "dInc": string,
            "hAlt": string,
            "hInc": string,
            "uAlt": string,
            "uInc": string
         },
         "boleto": {
            "cGerado": string,
            "cNumBancario": string,
            "cNumBoleto": string,
            "dDtEmBol": string,
            "nPerJuros": number,
            "nPerMulta": number
         },
         "nCodPedido": number,
         "bloquear_exclusao": string,
         "nCodOS": number,
         "cPedidoCliente": string,
         "cNumeroContrato": string,
         "recebimento": {
            "codigo_recebimento_integracao": string,
            "codigo_conta_corrente": number,
            "valor": number,
            "desconto": number,
            "juros": number,
            "multa": number,
            "data": string,
            "observacao": string
         },
         "repeticao": {
            "antecipar": string,
            "postergar": string,
            "mensal": {
               "repetir_todo_dia": number,
               "repetir_por": number
            },
            "semanal": {
               "repetir_dia_semana": string,
               "repetir_por": number
            },
            "especifico": {
               "repetir_a_cada": number,
               "repetir_por": number
            }
         },
         "aprendizado_rateio": string
      }
   ],
   "timeStamp": string,
   "total_registros": number
}

Exemplo de Resposta

{
   "success": true,
   "data": [
      {
         "codigo_lancamento_omie": 12345,
         "codigo_lancamento_integracao": "INT001",
         "codigo_cliente_fornecedor": "12345",
         "codigo_cliente_fornecedor_integracao": "CLI001",
         "data_vencimento": "2024-03-15",
         "valor_documento": 2500.00,
         "codigo_categoria": "VENDAS",
         "data_previsao": "2024-03-15",
         "categorias": [
            {
               "codigo_categoria": "VENDAS",
               "percentual": 100,
               "valor": 2500.00
            }
         ],
         "id_conta_corrente": 1,
         "numero_documento": "DOC001",
         "numero_parcela": "1/1",
         "codigo_tipo_documento": "BOLETO",
         "observacao": "Venda de produtos diversos",
         "status_titulo": "EM ABERTO",
         "info": {
            "cImpAPI": "S",
            "dAlt": "2024-03-01",
            "dInc": "2024-03-01",
            "hAlt": "10:00:00",
            "hInc": "10:00:00",
            "uAlt": "SISTEMA",
            "uInc": "SISTEMA"
         }
      }
   ],
   "timeStamp": "2024-03-01T10:00:00Z",
   "total_registros": 1
}

Códigos de Status

• 200: Sucesso
• 400: Requisição inválida
• 401: Não autorizado
• 403: Acesso proibido
• 500: Erro interno do servidor