# QI Tech — CertifiQI › Envio dos Documentos Documentação da QI Tech em texto corrido, para colar em um LLM. Fonte: https://docs.qitech.com.br 2 página(s). Índice: - Upload de Documentos em CNAB (/documentation/certifiqi/upload_documentos_cnab_assincrono) - Upload de Documentos em PDF (/documentation/certifiqi/upload_documentos_pdf) --- # Upload de Documentos em CNAB URL: /documentation/certifiqi/upload_documentos_cnab_assincrono # Utilização Esse método é utilizado para converter cada linha de um CNAB 444 em um arquivo PDF de forma assíncrona. O evento pode ser criado antes de finalizar a criação dos documentos. :::warning Aviso Importante! O campo `is_asynchronous` deve ser passado como TRUE na criação do evento. Os documentos estarão disponíveis para assinar depois de finalizar a geração dos documentos ::: ## Request ENDPOINT /certifier/document/trade_bill/asynchronous MÉTODO POST ### Request Body Params Deverão ser enviados os seguintes dados, como form-data , no body da request: | Campo | Tipo | Descrição | Obrigatório | |---|---|----------------------------------------|---| | `file` | file | Binário com o documento a ser enviado. | SIM | |`assignor_address`| string | Endereço do cedente | SIM | |`assignor_address_number`| string | Número do endereço do cedente | SIM | |`assignor_city`| string | Cidade dp cedente | SIM | |`assignor_state`| string | Estado do cedente | SIM | |`assignor_CEP`| string | CEP do cedente | SIM | |`assignor_neighborhood `|string | Bairro do cedente | SIM | ### Response STATUS 200 Response Body ```json [ { "control_number": "1123", "document_key": "d559e3dc-d19c-494e-b02e-b7199e5325ea", "file_size": 1679, "name": "trade_bill_1.pdf", "url": "https://storage.googleapis.com/certifier-api-storage-sandbox/d559e3dc-d19c-494e-b02e-b7199e5325ea/teste_of_original.pdf" }, { "control_number": "1123", "document_key": "d559e3dc-d19c-494e-b02e-b7199e5325ea", "file_size": 1679, "name": "trade_bill_2.pdf", "url": "https://storage.googleapis.com/certifier-api-storage-sandbox/d559e3dc-d19c-494e-b02e-b7199e5325ea/teste_of_original.pdf" }, { "control_number": "1123", "document_key": "d559e3dc-d19c-494e-b02e-b7199e5325ea", "file_size": 1679, "name": "trade_bill_3.pdf", "url": "https://storage.googleapis.com/certifier-api-storage-sandbox/d559e3dc-d19c-494e-b02e-b7199e5325ea/teste_of_original.pdf" } ] ``` STATUS 400 Response Body ```json { "title": "Bad Request", "description": "Document size larger than 20 MB" } ``` ## Request de Exemplo ```shell curl --location 'https://api.sandbox.certifiqi.com.br/document' \ --header 'x-api-token: chave de api' \ --form 'file=@"/seu_cnab.txt"' \ --form 'assignor_address="Rua"' \ --form 'assignor_address_number="1111"' \ --form 'assignor_city="São Paulo"' \ --form 'assignor_state="São Paulo"' \ --form 'assignor_CEP="123456789113"' \ --form 'assignor_neighborhood="Teste"' ``` --- # Upload de Documentos em PDF URL: /documentation/certifiqi/upload_documentos_pdf # Utilização Esse método deve ser utilizado para enviar os documentos no formato PDF. ## Request ENDPOINT /document MÉTODO POST ### Request Body Params Deverão ser enviados os seguintes dados, como form-data , no body da request: | Campo | Tipo | Descrição | Obrigatório| |---|---|---|---| | `file` | file | Binário com o documento a ser enviado. | SIM | | `control_number` | string | Campo livre que pode ser utilizado para fins de controle ou referência externa. | NÃO | |`endorsement_page` | booleano | Caso seja passado como true será adicionado uma Página de Endosso | NÃO | |`endorser_name` | string | Nome do Endossatário na página de endosso | NÃO | |`endorser_document_number` | string | Número do documento do endossatário na página de endosso | NÃO | |`receiver_name`| string | Nome do recebedor na página de endosso| NÃO | |`receiver_document_number`| string | Número do documento do recebedor na página de endosso | NÃO | | `document_identifier` |string | Identificador do documento na página de endosso | NÃO | | `document_type` |string | Tipo do documento na página de endosso | NÃO | ## Response STATUS 200 Response Body ```json [ { "control_number": "1123", "document_key": "d559e3dc-d19c-494e-b02e-b7199e5325ea", "file_size": 1679, "name": "document.pdf", "url": "https://storage.googleapis.com/certifier-api-storage-sandbox/d559e3dc-d19c-494e-b02e-b7199e5325ea/teste_of_original.pdf" }, ] ``` STATUS 400 Response Body ```json { "title": "Bad Request", "description": "Document size larger than 20 MB" } ``` Response Body ```json { "title": "Bad Request", "description": "PDF has editable format fields" } ``` Response Body ```json { "title": "Bad Request", "description": "PDF file can't have a password." } ``` ## Request de Exemplo ```shell curl --location 'https://api.certifiqi.com.br/document' \ --header 'x-api-token: chave de api' \ --form 'file=@"/seu_arquivo.pdf"' \ --form 'endorsement_page="true"' \ --form 'endorser_name="Endorser"' \ --form 'endorser_document_number="123456789112"' \ --form 'receiver_name="Receiver"' \ --form 'receiver_document_number="123456789113"' \ --form 'document_type="Termo de Cessão"' \ --form 'document_identifier="1234"' \ --form 'control_number="999"' ``` ## Adição da Página de Endosso Para adicionar uma página de endosso em preto ao final do PDF enviado, os seguintes campos devem ser informados: - endorsement_page como True - endorser_name - endorser_document_number - receiver_name - receiver_document_number - document_identifier - document_type Tendo esses campos enviados, o texto adicionado do endosso seguirá o seguinte formato: A instituição endorser_name , inscrita no CNPJ sob o nº endorser_document_number , endossa este(a) document_type de nº document_identifier para o(a) receiver_name , inscrito no CNPJ sob o nº receiver_document_number , nos termos da legislação aplicável, em especial do parágrafo 1º do artigo 29 da Lei nº 10.931, de 02 de agosto de 2004, com o objetivo de transferir a propriedade plena para a instituição ora indicada. O presente endosso é realizado em formato eletrônico, sendo que as partes, desde já, concordam e reconhecem a validade de sua assinatura eletrônica, nos termos do parágrafo 2º do artigo 10, da Medida Provisória nº 2.200, de 24 de agosto de 2001, ou norma que venha a substituí-la.