1. Contrato e Carta
APIs Qcertifica - Documentação Técnica
  • Instruções Gerais
    • Como começar
    • Raiz
  • Assinatura Automática
    • Como usar
    • Usuário Assinatura
      POST
  • Serviço Consulta NFe
    • Como usar
    • Autenticação
      POST
    • Importação de Lote de NFe
      POST
  • Download de Documentos
    • Como usar
    • Versão 1.0
      • Autenticação
        • Autenticar
      • Arquivos
        • Download de Arquivos
    • Versão 2.0
      • Requisição
        • Nova Requisição de Download
      • Documentos
        • Download de Documentos
  • EventosNfe
    • Como usar
    • SolicitarMonitoramento
      POST
  • Operações de crédito (RCWS002)
    • Autenticação
    • Contrato e Carta
      • ExcluirOperacao
        POST
      • CancelarDocumentoOperacao
        POST
      • ExcluirDocumentoOperacao
        POST
      • DownloadZipOperacao
        POST
      • ImportarCedentes
        POST
      • ExcluirRemessa
        POST
    • Importar Cedentes
      • Como usar
      • ConsultaCredito
    • Operação de crédito
      • CancelarOperacao
    • Importação Chave NFe
      • ImportarOperacao
    • Consultar Crédito
      • ImportarChaveNFe
  • Operações de crédito (RCWS001)
    • Autenticação
    • Operação de Crédito
      • ImportarRemessa
      • ConsultarRemessa
      • ImportarDocumento
      • DownloadZipRemessa
    • Contrato e Carta
      • ImportarOperacao
      • CacelarOperacao
      • DownloadArquivo
      • DownloadZipOperacao
    • Obter Carimbo do Tempo
      • ObtemCarimboDoTempo
    • Validar Token
      • ValidarToken
    • Consultar Crédito
      • ConsultaCredito
    • Obter Ticket Login
      • ObtemTicketLogin
    • Obter Versão Arquivos
      • ObtemVersaoArquivos
  • Contrato - Carta - CCB - Poderes e Alçadas (Modelo REST)
    • Como usar
    • Autenticação
      • Autenticação
      • Criar novo Token OAuth
    • KMS
      • Validar KMS
    • Assinatura
      • Como usar
      • Assinar Documento
    • CCB
      • Como usar
      • Registrar CCB
      • Cancelar CCB
      • Validar Titular de CCB
    • Poderes e Alçadas
      • Como usar
      • Cadastrar Poderes e Alçadas (v1.0 ou v2.0)
      • Consultar Poderes e Alçadas
    • Operações - Contrato
      • Como usar
      • Status Assinatura
      • Importar Contrato
      • Cancelar Contrato
      • Excluir Contrato
      • Baixar Zip de Documentos do Contrato
      • Excluir Documento do Contrato
      • Cancelar Documento do Contrato
    • Operações - Carta
      • Como usar
      • Importar Carta
      • Cancelar Carta
      • Excluir Carta
      • Baixar P7Ss da Carta
      • Baixar Documentos Originais da Carta
      • Baixar Relatórios de Assinatura da Carta
    • Esquemas
      • ResponseOauth
      • ResponseOauthError
      • RequestValidateKMS
      • ResponseValidateKMS
      • ResponseValidateKMSError
      • RequestSignDocument
      • ResponseSignDocumentError
      • AssinaturaModel
      • RequestRegisterDocument
      • ResponseRegisterDocument
      • RequestCancelDocument
      • ResponseDefaultDocument
      • AssinanteModel
      • RequestImportContract
      • ResponseBaseOp
      • ResponseImportContract
      • RequestImportLetter
      • RequestCancelOp
      • RequestExcludeOp
      • RequestDownloadOp
      • ResponseDownloadOp
      • RequestExcludeDocOp
      • RequestCancelDocOp
      • EmpresaPoderesSchema
      • RequestCadPowers
      • RequestCadPowersV2
      • RequestConsultaPowers
      • ResponseConsultaPowers
  • Carta
    • Como usar
    • ImportarCarta
    • ExcluirCarta
    • CancelarCarta
    • DownloadArquivosOriginaisCarta
    • DownloadArquivosComAssinaturaCarta
    • DownloadArquivosP7sCarta
    • DownloadRelatorioConferencia
  • Email Seguro
    • Como usar
    • EnviarEmail
    • EnviarEmailMonitorado
    • ReenviarEmail
    • EnviarEmailLote
  • Registro Duplicata Mercantil
    • Como usar
    • Autenticação
    • Registrar Duplicatas
    • Atualizar Pagamento da Duplicata
    • Excluir Registro de Duplicata
    • Consultar Status das Duplicatas
  • Consulta de Unicidade - Registro Duplicata Mercantil
    • Autenticação
    • Como usar
    • Solicita Verificação de Unicidade
    • Busca Validações
    • Esquemas
      • CheckInteropRequest
      • InteropTitleData
      • CheckInteropResponse
      • GETCheckInteropResponse
      • InteropResponse
      • InteropTitleDataResponse
      • ResponseError
  • Consulta Exposição de Cedentes
    • Autenticação
    • Como usar
    • Consulta Exposição de Cedente
    • Esquemas
      • ConsultAssignorMapResponse
      • AssignorMapResponse
      • ObjetoHistorico
      • ResponseError
  • P7s Webhook
    • Como usar
    • Autenticação
    • Receber P7s
  • Notificações Qcertifica
    • Como usar
    • Assinatura
      • Como usar
      • InformaAssinatura v1.0
      • InformaAssinatura v2.0
    • E-mail Monitorado
      • Como usar
      • InformaEmail - E-mail Seguro Monitorado
    • NF-e
      • Como usar
      • EventosNFe
    • Registro Duplicata
      • Como usar
      • Autenticação - Registro Duplicata
      • RetornoRegistro - Notificação de Registro de Duplicata
  • WebService Custodiante Finaxis
    • Como usar
    • cadastrar
    • alterarStatus
    • statusAssinatura
  • WebService Custodiante Vortx
    • Como usar
    • cadastrar
    • alterarStatus
    • statusAssinatura
  • WebService Custodiante Hemera
    • Como usar
    • cadastrar
    • alterarStatus
    • statusAssinatura
  • WebService Custodiantes Fromtis
    • Como usar
    • Certificação Digital
      • Requisição Certificação Digital
    • NFe
      • Requisição NFe
    • Cancelamento
      • Cancelamento de Operações
  1. Contrato e Carta

ImportarCedentes

POST
http://ws.qcertifica.com.br/RCWS002.asmx
Importa Carga de Cedentes para o Q'Certifica.
A importação dos cedentes é feita através de um XML, o layout deste XML segue o seguinte padrão:


Legenda:
Tipo: C = Caractere; N = Número; D = Data.
Tipo INFO: N = Nó; A = Atributo.`
IDCampoDescriçãoPaiObrig.TipoTipo INFOObservação
Q01CEDENTESTAG raizRaiz--N
Q02TOKENTOKENQ01SimCA(ver nota explicativa 1)
Q02_2VersaoVersaoQ01SimNA(Deve ser sempre = 2.0)
Q03CEDENTEGrupo de informação do CEDENTEQ01--N
Q04CNPJCNPJ do CEDENTEQ03SimNA(Somente números)
Q05RAZAORazão Social do CEDENTEQ03SimCA(maxlength = 55)
Q06FANTASIANome Fantasia do CEDENTEQ03SimCA(maxlength = 40)
Q07TIPOPESSOATipo do CEDENTEQ03SimCAPode ser “F” (física) ou “J” (jurídica)
Q08CPFCEDENTECPF do CEDENTEQ03SimCA(Somente números)
Q09NOMECEDENTENome do CEDENTEQ03SimCA(maxlength = 55)
Q10ENDERECOGrupo de informação do endereçoQ03Sim-N
Q11CEPCEPQ10SimNN(Somente números)
Q12ENDEndereço do CEDENTEQ10SimCN(maxlength = 145)
Q13NRONúmero do EndereçoQ10SimCN(maxlength = 6)
Q14CPLComplemento do EndereçoQ10NãoCN(maxlength = 75)
Q15BAINome do BairroQ10NãoCN(maxlength = 75)
Q16CIDNome da CidadeQ10SimCN(maxlength = 50)
Q17UFSigla do Estado do CEDENTEQ10SimCN(maxlength = 2)
Q18MAILE-mail do CedenteQ10SimCN(maxlength = 255)
Q19FONEContato do CedenteQ10SimNNOs três primeiros números são o DDD da área e o restante corresponde ao número. (Somente números)
Q20PARTESGrupo de informação das PartesQ03--N
Q21PARTEGrupo de Informação da ParteQ20--N
Q22TIPOTipo da ParteQ21NãoCA(ver nota explicativa 2)
Q23PESSOAGrupo de informação da pessoaQ21--NQuando for individual filho do Q20, quando for grupo utilizar Q53.
Q24CDGCódigo da PessoaQ23NãoCNNulo para novas inserções
Q24NOMNome da PessoaQ23SimCN(maxlength = 50)
Q25LOGLoginQ23NãoCN(maxlength = 50)
Q26CPFNúmero do CPF ou CNPJ da Pessoa. CPF -11 CNPJ - 14Q23SimCN(Somente números)
Q27MAILE-mail da PessoaQ23SimCN(maxlength = 255)
Q28NASCData de NascimentoQ23SimDNDD/MM/AAAA  HH24:MI:SS
Q29RGNúmero do RGQ23SimCN(Somente números)
Q30ORGEXPÓrgão ExpedidorQ23SimCN
Q31ASSELEDDDDDDQ23NãoNN(ver nota explicativa 6)
Q32ASSELECELNúmero celularQ23NãoNN(ver nota explicativa 6)
Q33EMIData de Emissão pelo Órgão ExpedidorQ23SimDNDD/MM/AAAA  HH24:MI:SS
Q34ENDERECOGrupo de Informação do endereço da pessoaQ23Sim-N
Q35CEPCEPQ32SimNN(Somente números)
Q36ENDEndereço da PessoaQ32SimCN(maxlength = 145)
Q37NRONúmero do Endereço da PessoaQ32SimCN(maxlength = 6)
Q38CPLComplemento do EndereçoQ32NãoCN(maxlength = 75)
Q39BAINome do BairroQ32NãoCN(maxlength = 75)
Q40CIDNome da CidadeQ32SimCN(maxlength = 50)
Q41UFSigla da UF da PessoaQ32SimCN(maxlength = 2)
Q42FONEContato da PessoaQ32SimNNOs três primeiros números são o DDD da área e o restante corresponde ao número.
Q43DOCUMENTOGrupo de informação do DocumentoQ21--N
Q44TIPOTipo do DocumentoQ21NãoNA(ver nota explicativa 3)
Q45VLR_LIMITEValor limite do grupoQ21SimNNPermitido somente para duplicatas e para notas promissórias quando for gerado pelo sistema, caso venha como documento avulso este parâmetro não será considerado.
Q46DT_VIGENCIAData de validade do grupoQ21SimDNDD/MM/AAAA  HH24:MI:SS
Q47ATU_PODERAtualização dos poderesQ21SimCN(ver nota explicativa 4)
Q48PODERESGrupo de informações dos poderes do grupoQ21--NTodos os poderes do grupo deverão ser assinados pelos assinantes até que a quantidades de assinaturas seja atendida.
Q49PODERCódigo do poderQ46NãoCN(ver nota explicativa 5)
Q50PODERCódigo do poderQ46NãoCN(ver nota explicativa 5)
Q51PARTEGrupo de Informação da ParteQ20--N
Q52TIPOTipo da ParteQ49NãoCA(ver nota explicativa 2)
Q53GRUPOGrupo de informações do Grupo de AssinantesQ49--N
Q54NOM_GRUPONome do GrupoQ51NãoCN(maxlength = 200)
Q55NUM_ASS_NECNúmero de assinaturas necessáriasQ51SimNN(Deve ser menor ou igual ao numero total de assinantes do grupo)
Q56NUM_ASS_OBRNúmero de assinaturas obrigatóriasQ51NãoNN(Deve ser menor ou igual ao numero total de assinantes com OBRIGATORIO="S" no grupo)
Q57DOCUMENTOGrupo de informação do DocumentoQ51--N
Q58TIPOTipo do DocumentoQ55NãoNA(ver nota explicativa 3)
Q59VLR_LIMITEValor limite do grupoQ55SimNNPermitido somente para duplicatas e para notas promissórias quando for gerado pelo sistema, caso venha como documento avulso este parâmetro não será considerado.
Q60DT_VIGENCIAData de validade do grupoQ55SimDNDD/MM/AAAA  HH24:MI:SS
Q61ATU_PODERAtualização dos poderesQ55SimCN(ver nota explicativa 4)
Q62PODERESGrupo de informações dos poderes do grupoQ55--NTodos os poderes do grupo deverão ser assinados pelos assinantes até que a quantidades de assinaturas seja atendida.
Q63PODERDescrição do poderQ60NãoCN(ver nota explicativa 5)
Q64PODERDescrição do poderQ60NãoCN(ver nota explicativa 5)
Q65PESSOASGrupo de informações de pessoas do grupoQ51--N
Q66OBRIGATORIOIndica se a pessoa é um assinante obrigatório.Q63SimCA('S' ou 'N')
Q67NOMNome da PessoaQ63SimCN
Q68CPFNúmero do CPF ou CNPJ da Pessoa. CPF -11 CNPJ - 14Q63SimCN(Somente números)
Q69MAILE-mail da PessoaQ63SimCN(maxlength = 255)
Q70NASCData de NascimentoQ63SimDNDD/MM/AAAA  HH24:MI:SS
Q71RGNúmero do RGQ63SimCN(Somente números)
Q72ORGEXPÓrgão ExpedidorQ63SimCN
Q73EMIData de Emissão pelo Órgão ExpedidorQ63SimDNDD/MM/AAAA  HH24:MI:SS
Q74ENDERECOGrupo de Informação do endereço da pessoaQ63Sim-N
Q75CEPCEPQ72SimNN(Somente números)
Q76ENDEndereço da PessoaQ72SimCN(maxlength = 145)
Q77NRONúmero do Endereço da PessoaQ72SimCN(maxlength = 6)
Q78CPLComplemento do EndereçoQ72NãoCN(maxlength = 75)
Q79BAINome do BairroQ72NãoCN(maxlength = 75)
Q80CIDNome da CidadeQ72SimCN(maxlength = 50)
Q81UFSigla da UF da PessoaQ72SimCN(maxlength = 2)
Q82FONEContato da PessoaQ72SimNNOs três primeiros números são o DDD da área e o restante corresponde ao número.
NOTAS EXPLICATIVAS
NotaCampoConteúdo / Significado
1TOKENO token será concedido à consultoria no momento de fechamento do contrato de utilização do sistema Q’Certifica. Este código é único da consultoria, é utilizado como chave de acesso ao WebService do Q’Certifica.
2Tipo (Tipos de Parte)I - Individual: Uma pessoa que representa a entidade em questão. G - Grupo: Duas ou mais pessoas que representam a entidade em questão, a assinatura só será válida após a regra do grupo ser atendida.
3Tipo (Tipos de Documentos)Deve ser enviado sempre o valor 1
4Atualização dos poderesS – Os poderes serão atualizados com os novos enviados no arquivo XML, excluindo os anteriormente cadastrados. N – Os poderes enviados no arquivo XML serão inseridos, sem excluir os anteriores.
5PODERDeve descrever o poder dos assinantes. O texto é livre não podendo ultrapassar o tamanho discriminado para o campo.
6ASSELEDDD ASSELECELEstes campos são exclusivamente para configuração da assinatura eletrônica, então se forem preenchidos o usuário em questão terá permissões para assinar eletronicamente.
Segue exemplo de um XML com este layout:
<?xml version="1.0" encoding="utf-8"?>
<CEDENTES TOKEN="?" Versao="2.0">
   <CEDENTE CNPJ="?" RAZAO="?" FANTASIA="?" TIPOPESSOA="?" CPFCEDENTE="?" NOMECEDENTE="?">
      <ENDERECO>
         <CEP>?</CEP>
         <END>?</END>
         <NRO>?</NRO>
         <CPL />
         <BAI>?</BAI>
         <CID>?</CID>
         <UF>?</UF>
         <MAIL>?</MAIL>
         <FONE>?</FONE>
      </ENDERECO>
      <PARTES>
         <PARTE TIPO="I">
            <PESSOA>
               <NOM>?</NOM>
               <LOG>?</LOG>
               <CPF>?</CPF>
               <MAIL>?</MAIL>
               <NASC>?</NASC>
               <RG />
               <ORGEXP />
               <ASSELEDDD>?</ASSELEDDD>
               <ASSELECEL>?</ASSELECEL>
               <EMI />
               <ENDERECO>
                  <CEP>?</CEP>
                  <END>?</END>
                  <NRO>?</NRO>
                  <CPL />
                  <BAI>?</BAI>
                  <CID>?</CID>
                  <UF>?</UF>
                  <FONE>?</FONE>
               </ENDERECO>
            </PESSOA>
            <DOCUMENTOS>
               <DOCUMENTO TIPO="?" VLR_LIMITE="?" DT_VIGENCIA="?" ATU_PODER="?">
                  <PODERES>
                     <PODER>?</PODER>
                  </PODERES>
               </DOCUMENTO>
            </DOCUMENTOS>
         </PARTE>
         <PARTE TIPO="G">
            <GRUPO>
               <NOM_GRUPO>?</NOM_GRUPO>
               <NUM_ASS_NEC>?</NUM_ASS_NEC>
               <NUM_ASS_OBR>?</NUM_ASS_OBR>
               <DOCUMENTOS>
                  <DOCUMENTO TIPO="?" VLR_LIMITE="?" DT_VIGENCIA="?" ATU_PODER="?">
                     <PODERES>
                        <PODER>?</PODER>
                     </PODERES>
                  </DOCUMENTO>
               </DOCUMENTOS>
               <PESSOAS>
                  <PESSOA OBRIGATORIO="?">
                     <NOM>?</NOM>
                     <CPF>?</CPF>
                     <MAIL>?</MAIL>
                     <NASC>?</NASC>
                     <RG>?</RG>
                     <ORGEXP>?</ORGEXP>
                     <ASSELEDDD>?</ASSELEDDD>
                     <ASSELECEL>?</ASSELECEL>
                     <EMI>?</EMI>
                     <ENDERECO>
                        <CEP>?</CEP>
                        <END>?</END>
                        <NRO>?</NRO>
                        <CPL>?</CPL>
                        <BAI>?</BAI>
                        <CID>?</CID>
                        <UF>?</UF>
                        <FONE>?</FONE>
                     </ENDERECO>
                  </PESSOA>
                  <PESSOA OBRIGATORIO="?">
                     <NOM>?</NOM>
                     <CPF>?</CPF>
                     <MAIL>?</MAIL>
                     <NASC>?</NASC>
                     <RG>?</RG>
                     <ORGEXP>?</ORGEXP>
                     <EMI>?</EMI>
                     <ENDERECO>
                        <CEP>?</CEP>
                        <END>?</END>
                        <NRO>?</NRO>
                        <CPL>?</CPL>
                        <BAI>?</BAI>
                        <CID>?</CID>
                        <UF>?</UF>
                        <FONE>?</FONE>
                     </ENDERECO>
                  </PESSOA>
               </PESSOAS>
            </GRUPO>
         </PARTE>
      </PARTES>
   </CEDENTE>
</CEDENTES>
Este Xml de ser enviado como STRING na TAG XML da Requisição

Requisição

Parâmetros de Consulta

Parâmetros Header

Parâmetros Bodyapplication/xml

Examples

Respostas

🟢200OK
application/xml
Requisição recebida com sucesso.
Bodyapplication/xml

Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'http://ws.qcertifica.com.br/RCWS002.asmx?op=ImportarCedentes' \
--header 'SOAPAction: https://ws.qcertifica.com.br/ImportarCedentes' \
--header 'Content-Type: text/xml; charset=utf-8' \
--data '<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
  <soap12:Body>
    <tns:ImportarCedentes xmlns:tns="https://ws.qcertifica.com.br/">
      <tns:data>
        <tns:Token>string</tns:Token>
        <tns:Xml>string</tns:Xml>
      </tns:data>
    </tns:ImportarCedentes>
  </soap12:Body>
</soap12:Envelope>'
Response Response Example
<?xml version="1.0" encoding="utf-8"?>
<soap12:Envelope xmlns:soap12="http://www.w3.org/2003/05/soap-envelope">
  <soap12:Body>
    <tns:ImportarCedentesResponse xmlns:tns="https://ws.qcertifica.com.br/">
      <tns:ImportarCedentesResult>
        <tns:Mensagem>string</tns:Mensagem>
        <tns:Situacao>Sucesso</tns:Situacao>
      </tns:ImportarCedentesResult>
    </tns:ImportarCedentesResponse>
  </soap12:Body>
</soap12:Envelope>
Modificado em 2026-07-27 20:27:35
Página anterior
DownloadZipOperacao
Próxima página
ExcluirRemessa
Built with