1. Operações
Qprof
  • Qprof API
    • Guia de Integração
      • Primeiros Passos & Autenticação
      • Compressão gzip
    • Autenticação
      • Geração de token de acesso
    • Consultas
      • Consultar espécies de documento (Versão 1.0.0)
      • Consultar indexadores (Versão 1.0.0)
      • Consultar rótulos (Versão 1.0.0)
      • Consultar motivos controladoria (Versão 1.0.0)
    • Cadastro Pessoa
      • Agente
        • Consultar
        • Inserir
        • Atualizar
        • Excluir
      • Cadastrar Pessoa (Versão 1.0.0)
      • Cadastrar Representante (Versão 1.0.0)
      • Cadastrar Contrato/Modalidade (Versão 1.0.0)
      • Consultar Listas de Valores (Versão 1.0.0)
      • Cadastrar Cônjuge (Versão 1.0.0)
      • Cadastrar Conta e Favorecido (Versão 1.0.0)
      • Cadastro Contrato Geral
      • Cadastro de Observação Pessoa (Versão 1.0.0)
      • Atualizar Faturamento
    • Cedente
      • Tarifas
        • Consultar
        • Inserir
        • Atualizar
        • Excluir
      • Informações Operacionais
    • Cobrança
      • Consultar Status
      • Inserir Ocorrência de Cobrança em Título
      • Importar Retorno Bancário
    • Operações
      • Importar Títulos (Versão 5.0.0)
        POST
      • Listar Favorecido
        GET
      • Importar CNAB (Versão 2.0.0)
        POST
      • Simular Operação (Versão 2.0.0)
        POST
      • Importar Documento
        POST
      • Consultar Títulos (Versão 2.0.0)
        GET
      • Emitir Boletos
        POST
      • Validar Acesso
        GET
      • Instruções a Regularizar (Versão 1.0.0)
        POST
      • Consulta Arquivos de Retorno Cedente (Versão 1.0.0)
        POST
      • Consulta de Operações (Versão 2.0.0)
        GET
      • Consulta de Tarifas de Operação (Versão 1.0.0)
        POST
      • Operação de Crédito Estruturado (Versão 2.0.0)
        POST
      • Importar Documento (sem borderô)
        POST
    • Relatórios
      • Emitir Relatório (Versão 1.0.0)
    • Retorno de Status de Operação
      • Callback: Retorno de Status de Operação (`atualizaStatus`)
    • Monitoramento NFe
      • Monitoramento NFe — Visão Geral do Fluxo
      • Callback: Início do Monitoramento (`monitoraNfe`)
      • Callback: Parar/Continuar Monitoramento (`alteraStatusMonitoramento`)
      • Receber Status Monitoramento
    • Controladoria
      • Atualizar Status Checagem Título
      • Inserir Ocorrência de Controladoria em Título
      • Atualizar Títulos em Tranche
      • Atualizar Chave Fiscal Título
    • Esquemas
      • importar_retorno_bancario
      • importar_retorno_bancario_success
      • authorization_request
      • authorization_response_denied
      • importar_operacao
      • importar_operacao_2
      • valores_titulo
      • valor_titulo
      • valores_titulo_2
      • valor_titulo_2
      • valores_titulo_3
      • valor_titulo_3
      • telefone
      • valores_titulo_5
      • endereco
      • valor_titulo_5
      • simular_operacao
      • simular_operacao_v2
      • lista_titulo
      • info_titulo
      • importar_operacao_request_sucess
      • importar_documento_request_sucess
      • simular_operacao_request_sucess
      • simular_operacao_request_sucess_v2
      • importar_operacao_request_denied
      • simular_operacao_request_denied
      • importar_documento_request_denied
      • importar_operacao_request_failed
      • simular_operacao_request_failed
      • importar_documento_request_failed
      • retorna_status_ope
      • titulos
      • titulo
      • titulos_importados
      • sequencial
      • sequencial1
      • retorna_status_resultado
      • monitora_status_nfe
      • atualiza_status_checagem_titulo
      • inserir_ocorrencia_controladoria_titulo
      • inserir_ocorrencia_cobranca_titulo
      • atualiza_titulo_tranche
      • notasV2
      • notaV2
      • monitora_nfe_sucess
      • atualiza_chave_fiscal_titulo
      • atualiza_status_checagem_sucesso
      • atualizar_chave_fiscal_titulo_sucesso
      • atualizar_titulo_tranche_sucesso
      • insert_ocorr_cob_success
      • monitora_nfe_error
      • monitora_nfe_denied
      • consultar_titulo
      • consultar_titulo_request_denied
      • consultar_titulo_request_failed
      • consultar_titulo_request_sucess
      • lista_titulo_cliente
      • consultar_titulo_request_sucess_v2
      • lista_titulo_cliente_v2
      • emitir_boletos
      • lista_titulo_boleto
      • emitir_boletos_request_denied
      • emitir_boletos_request_failed
      • importar_operacao_cnab
      • favorecidos
      • informacao
      • lista_fav_request_sucess
      • lista
      • importar_operacao_3
      • valida_acesso
      • request_denied
      • request_failed
      • titulos_e_suas_instruções
      • lista_titulo_instrucoes_a_regularizar
      • consultar_arquivos_retorno_cedente
      • consultar_status_inst
      • cadastrar_conjuge_pess
      • cadastrar_representante_pess
      • cadastrar_contrato_pess
      • cadastrar_pss
      • cadastrar_conta_favorecido
      • status_inst_request_sucess
      • cadastro_conta_favorecido_status
      • cadastro_conjuge_status
      • cadastro_pessoa_status
      • cadastro_represen_status
      • cadastro_contrato_status
      • lista_instrucoes
      • instrucao
      • info_operacionais
      • info_operacionais_sucess
      • tarifas_consulta_request
      • tarifas_inserir_request
      • tarifas_atualizar_request
      • tarifas_excluir_request
      • tarifas_consulta_result
      • tarifas_consulta
      • debito_credito
      • concentracao_sacado
      • sacados
      • limites_contrato
      • limites
      • consultar_operacoes_retorno
      • consultar_operacoes_retorno_v2
      • consultar_tarifas_operacao_retorno
      • consultar_operacoes_request_sucess
      • consultar_operacoes_request_sucess_v2
      • consultar_tarifas_operacoes_request_sucess
      • lista_operacoes_na_data
      • emitir_relatorio
      • lista_resposta_consulta_especies_documento
      • resposta_consulta_especie_documento
      • lista_resposta_consulta_indexadores
      • resposta_consulta_indexadores
      • lista_resposta_consulta_rotulos
      • resposta_consulta_rotulos
      • credito_estruturado_request_sucess
      • credito_estruturado_request_sucess_v2
      • operacao_credito_estruturado
      • detalhamento_parcelas
      • parcela_info
      • importar_operacao_4
      • importar_operacao_cnab_2
      • person_observation_attributes
      • person_observation_success
      • agente_consulta_request
      • agente_update_insert_request
      • importar_operacao_5
      • agente_consulta_result
      • agente_update_result
      • agente_insert_result
      • agente_delete_result
      • contrato_geral_insert
      • regra_filtro
  • OData Standard
    • Visão Geral
    • Guia de Conexão
      • Conexão via Power BI e Excel
      • Conexão via Postman
      • Conexão via Python
    • Dicionário de Dados
      • Definições
      • Entidades
    • Base de Conhecimento
      • FAQ — Exemplos de Consultas
      • Análise de Crédito — Baixados no Período
      • Medidas DAX (Power BI)
  1. Operações

Importar Títulos (Versão 5.0.0)

POST
/servicos/operacao/importarOperacao
Método para importação de títulos para a realização de operações no Qprof. Quando preenchido campo CMC7 será considerada uma operação de cheque senão duplicata.
Nota Versão 5.0.0: É possível enviar uma observação para o título. Foi adicionado o campo "observacao" ao conteúdo de cada título, que aceita uma string de até 4000 caracteres. Caso seja necessário enviar um JSON neste campo, ele deve ser informado como string com as aspas escapadas, por exemplo: "observacao": "{"nome":"João","idade":30}".
⚠️ Compressão obrigatória: o corpo desta requisição (JSON) deve ser enviado comprimido em gzip.

Diferenças entre versões#

v2.0.0 — Permite enviar operações pré-calculadas (campo operacao_pre_calculada e valor_aquisicao). Recomenda-se sempre enviar a taxa_desagio utilizada; o Q'Prof não recalcula quando informada.
v3.0.0 — Permite enviar operações com favorecidos e dados de endosso (nosso_numero, cpf_cnpj_endossante, nome_endossante, cfops). Use o método "Lista de Favorecidos" para auxiliar no preenchimento.
v4.0.0 — Permite indicar fase_liberacao, executa_filtro, taxa_desagio, endossante e codigo_Rotulo (consultável em "Consulta de rótulos").
v5.0.0 — Adiciona o campo observacao em cada título (string até 4000 caracteres). Para enviar um JSON nesse campo, informe-o como string com aspas escapadas, ex.: "observacao": "{\"nome\":\"João\",\"idade\":30}".

Requisição

Parâmetros de Consulta

Parâmetros Header

Parâmetros Bodyapplication/json

Examples

Respostas

🟢200
application/json
OK
Bodyapplication/json

🟠400
🟠401
Request Request Example
Shell
JavaScript
Java
Swift
cURL
curl --location 'https://prod.your-api-server.com/servicos/operacao/importarOperacao?version=5.0.0' \
--header 'Authorization: Bearer {{token}}' \
--header 'Content-Type: application/json' \
--data-raw '{
    "cnpj_empresa": "00.000.000/0000-00",
    "cpf_cnpj_cedente": "000.000.000-00 ou 00.000.000/0000-00",
    "titulos": [
        {
            "cpf_cnpj_sacado": "000.000.000-00 ou 00.000.000/0000-00",
            "nome_sacado": "Sacado Teste",
            "endereco_sacado": {
                "endereco": "Rua teste",
                "numero": "123456",
                "bairro": "Bairro",
                "cidade": "Cidade",
                "uf": "SC",
                "cep": 89107000,
                "email": "teste@quicksoft.com.br"
            },
            "telefone_sacado": {
                "ddd": 47,
                "numero": 999999999
            },
            "numero_titulo": "12456333",
            "data_emissao": "2019-12-01",
            "data_vencimento": "2019-12-01",
            "valor_nominal": 123.11,
            "valor_desconto": 123.11,
            "chave_nfe": 11111111111111,
            "cmc7": "000000000000000000000000000000"
        }
    ],
    "observacao": "observação operação",
    "tipo_documento": "D"
}'
Response Response Example
200 - Sucesso
{
    "numero_bordero": 1,
    "mensagem": "Operação importada com sucesso."
}
Modificado em 2026-06-30 19:55:16
Página anterior
Importar Retorno Bancário
Próxima página
Listar Favorecido
Built with