A importação de arquivo .ofx pela API Movere permitirá muito mais agilidade no processo, podendo enviar um ou mais arquivos que serão recebidos e importados de maneira automática.  Segue o endpoint responsável pela recepção dos arquivos: 

Agora uma documentação técnica em como utilizar o endpoint:


O que é este endpoint?


Este endpoint recebe arquivos de extrato bancário no formato OFX enviados pelo cliente para iniciar o processo de conciliação bancária. Após o recebimento, o sistema armazena o arquivo junto com os dados bancários informados e notifica o cliente por meio de uma URL de callback quando o processamento for concluído.


---

Como fazer a requisição


A chamada deve ser feita via HTTP POST para iacaoBancaria, utilizando o Content-Typemultipart/form-data. Não é possível usar application/json neste endpoint, pois o envio de arquivo é obrigatório.


A requisição precisa conter um token JWT válo formato Bearer {token}. Além disso, ousuário autenticado precisa ter permissão na rotina R1140 (Solicitação de Importação de Extrato Bancário de Conta Corrente) com direito de inclusão.


curl --location 'https://api.moveresoftware.com/api/ImportacaoConcialiacaoBancaria' \
--header 'Authorization: Bearer {{token}}' \
--form 'urlConfirmacao="https://webhook.site/f5e9c34e-4b14-4b89-97c4-4cbc12878d51"' \
--form 'arquivo=@"/C:/Downloads/testarImportacao.ofx"' \
--form 'banco="0001"' \
--form 'agencia="41511"' \
--form 'contaSemDigito="51515441"'


---

Campos obrigatórios


urlConfirmacao — URL de callback que o sistema utilizará para notificar o cliente após o processamento do arquivo. Deve ser uma URL acessível pelo servidor. Não pode ser vazia.


arquivo — Arquivo do extrato bancário a ser importado. Somente arquivos com extensão .ofx são aceitos. O campo não pode ser enviado vazio.


banco — Código numérico do banco como texto. Por exemplo, 001 para Banco do Brasil.


agencia — Número da agência bancária sem o dmo texto.


contaSemDigito — Número da conta corrente sem o dígito verificador, enviado como texto.


O código da empresa é obtido automaticamente a partir do token de autenticação e não precisa ser informado na requisição.


---

Respostas possíveis


Se todos os campos estiverem corretos e o arquivo for aceito, o endpoint retorna HTTP 200 com a mensagem "Arquivo OFX recebido com sucesso.".


Se o arquivo for identificado como duplicado ou apresentar algum problema durante o salvamento, o endpoint também

retorna HTTP 200, porém com a mensagem "Arquro, favor verificar!". Neste caso, o clientedeve tratar o conteúdo da resposta para identificar que o arquivo não foi aceito, já que o código HTTP não diferencia este cenário do sucesso.


Caso algum campo obrigatório esteja ausente, vazio, ou o arquivo não seja do tipo .ofx, o endpoint retorna HTTP 400 com uma mensagem descritiva indicando qual campo está incorreto. O mesmo acontece se a requisição for enviada com um

Content-Type diferente de multipart/form-dat


---

Observações importantes


Os campos banco, agencia e contaSemDigito detexto, mesmo que contenham apenas números.Isso evita problemas com zeros à esquerda em códigos de banco e agência.


A URL informada em urlConfirmacao precisa estar acessível pelo servidor no momento em que o processamento for concluído. URLs internas ou de localhost não funcionarão em ambiente de produção.


O processamento do arquivo ocorre de forma a O retorno HTTP 200 confirma apenas que oarquivo foi recebido e armazenado com sucesso, não que a conciliação já foi concluída.