Exportação
Integração MedicalPay
MedicalPay - Recebíveis (csv)
Guia do usuário: como gerar o arquivo e o que significa cada campo
1. Para que serve
A integração MedicalPay gera um arquivo (planilha CSV) com os títulos a pagar em aberto lançados para os médicos prestadores. Esse arquivo é enviado à MedicalPay, que usa as informações para processar os pagamentos dos serviços prestados pelos médicos.
Cada linha do arquivo é um título do financeiro. Junto com o título vão:
• os dados da empresa que está enviando o arquivo (chamada de cedente);
• a conta ou chave PIX em que a empresa recebe;
• os dados do médico prestador (CPF, CRM, contatos);
• os valores e datas do título;
• a nota fiscal eletrônica (chave e XML), quando existir.
2. Antes de gerar: confira os cadastros
O arquivo é montado com o que já está cadastrado no sistema. Se um cadastro estiver incompleto, o campo correspondente vai em branco ou o título nem entra no arquivo. Antes de gerar, confira:
|
Onde |
O que precisa estar preenchido |
|
Configurações > Empresa aba Home |
CNPJ, Razão Social, Telefone e Email da empresa. |
|
Configurações > Empresa aba Movimentação |
Id agente padrão: o agente que representa a própria empresa. É nele que ficam a conta bancária e a chave PIX de recebimento. |
|
Cadastros > Agentes > Cad. de Agentes (agente da empresa) aba Adicionais > Contas Bancárias |
Uma conta com Tipo Pagamento (Pix, Transferência ou Depósito) e os dados correspondentes. Se houver mais de uma, marque a principal em Conta Padrão?. |
|
Cadastros > Agentes > Cad. de Agentes (cada médico) |
Aba Dados: Nome, CNPJ/CPF, um telefone e um e-mail. Aba Adicionais > Pessoais: Data Nasc, CR Numero e CR Uf. |
|
Financeiro do título |
Tipo Financeiro = Pagar, agente = médico, Tipo, Emissão, Vencimento, Valor líquido e, se quiser, Observação. |
Importante: médicos sem CR Numero ou sem CR Uf preenchidos ficam fora do arquivo, mesmo que tenham títulos em aberto.
3. Como gerar o arquivo
1. Acesse o menu Utilitários > Exportação > Diversos. A tela se chama Gera Arquivo Exportação.
|
|
2. Em Data Inicial e Data Final, informe o período de vencimento dos títulos que devem ir no arquivo.
|
|
3. No campo Arquivo, escolha MedicalPay - Recebíveis. O campo Empresas passa a aparecer.
|
|
4. Em Tipos Movimento, selecione um ou mais tipos de movimento dos títulos. Para marcar mais de um, segure Ctrl e clique em cada tipo.
|
|
5. (Opcional) Em Empresas, selecione as empresas cujos títulos devem ir no arquivo. Para marcar mais de uma, segure Ctrl. Se não marcar nenhuma, vale a empresa em que você está logado.
6. Clique em Gerar. Ao terminar, a tela mostra Concluído... N título(s). e o link do arquivo em Arquivos Gerados.
7. Clique com o botão direito sobre o link e escolha Salvar link como... para baixar o arquivo.
4. Filtros da tela
|
Filtro |
Obrigatório? |
Para que serve |
|
Arquivo |
Sim |
Escolha MedicalPay - Recebíveis. |
|
Data Inicial e Data Final |
Sim |
Período de vencimento dos títulos. Só entram títulos com vencimento entre as duas datas (inclusive). |
|
Tipos Movimento |
Sim |
Só entram títulos dos tipos de movimento marcados. Aceita vários (Ctrl + clique). Sem nenhum marcado, o arquivo não é gerado. |
|
Empresas |
Não |
Só aparece quando o Arquivo é MedicalPay. Lista as empresas liberadas para o seu usuário. Em branco = empresa logada. |
Os demais campos da tela (Cliente, Centro Custo, Formulário etc.) não são usados por esta integração.
Quais títulos entram no arquivo
Um título só vai para o arquivo quando atende a todas as condições abaixo:
• é um título a pagar (Tipo Financeiro = Pagar);
• está em aberto, ou seja, ainda sem Data Pgto;
• o vencimento está dentro do período informado;
• o tipo de movimento está entre os selecionados;
• pertence a uma das empresas selecionadas (ou à empresa logada);
• o médico tem CR Numero e CR Uf preenchidos.
5. Mensagens que podem aparecer
|
Mensagem |
O que significa |
O que fazer |
|
Tipo movimento não selecionado! |
Nenhum tipo foi marcado em Tipos Movimento. |
Marque pelo menos um tipo de movimento e gere novamente. |
|
Nenhum título a receber em aberto encontrado no período. |
Nenhum título atendeu às condições do item 4. |
Confira o período, os tipos de movimento, as empresas e se os médicos têm CR Numero e CR Uf. |
|
Concluído... N título(s). |
Arquivo gerado com N títulos. |
Baixe o arquivo pelo link em Arquivos Gerados. |
6. O arquivo gerado
• Nome: MEDICALPAY_(código da empresa)_(mês)_(ano).csv. Mês e ano vêm da Data Final. Exemplo: MEDICALPAY_21101_09_2026.csv.
• Primeira linha: nomes das colunas. Cada linha seguinte é um título.
• Separador: ponto e vírgula ( ; ).
• Datas: dia/mês/ano, por exemplo 30/09/2026.
• Valores: ponto como separador decimal e duas casas, sem separador de milhar, por exemplo 1500.00.
• CPF, CNPJ e chave da NF-e: só números, sem pontos, traços ou barras.
• Campos sem informação: ficam em branco.
Dica para conferir no Excel: ao abrir o CSV com dois cliques, o Excel pode mostrar CPF, CNPJ e chave da NF-e em notação científica (ex.: 5,29E+10). Para conferir sem isso, abra pelo menu Dados > De Texto/CSV e defina essas colunas como Texto. Não salve o arquivo pelo Excel antes de enviar: ele pode alterar esses números.
7. O que significa cada campo e de onde vem
As tabelas abaixo seguem a ordem das colunas do arquivo. A coluna De onde vem mostra a tela e o campo do sistema em que a informação é cadastrada.
7.1 Empresa (cedente)
Dados da empresa que envia o arquivo. O sistema usa o agente informado em Configurações > Empresa, aba Movimentação, campo Id agente padrão. Os dados vêm do cadastro desse agente em Cad. de Agentes, assim como os dados do médico
|
Coluna do arquivo |
O que significa |
De onde vem |
Formato / exemplo |
|
cedenteCnpj |
CNPJ da empresa. |
Campo CNPJ. |
Só números 12345678000199 |
|
cedenteRazaoSocial |
Razão social da empresa. |
Cad. de Agentes, campo Nome. |
Texto |
|
cedenteTipo |
Tipo de pessoa da empresa. |
Preenchido automaticamente. |
Sempre PJ |
|
cedenteDataAbertura |
Data de abertura da empresa. |
Cad. de Agentes, campo Data Exp/Abertura |
Data. Em branco se não preenchido |
|
cedenteEmail |
E-mail da empresa. |
Cad. de Agentes, quadro de E-mails: o primeiro e-mail preenchido. |
contato@empresa.com.br |
|
cedenteDdd |
DDD do telefone da empresa. |
Cad. de Agentes, quadro de Telefones: os 2 primeiros dígitos do primeiro telefone preenchido. |
22 |
|
cedenteTelefone |
Telefone da empresa, sem DDD. |
Cad. de Agentes, quadro de Telefones: o restante do número. |
27852614 |
7.2 Dados de recebimento da empresa
Conta ou chave PIX em que a empresa recebe. O sistema usa o agente informado em Configurações > Empresa, aba Movimentação, campo Id agente padrão, e busca a conta desse agente em Cad. de Agentes > aba Adicionais > Contas Bancárias. Se houver mais de uma conta, usa a marcada em Conta Padrão?.
Vai PIX ou TED, nunca os dois:
• Tipo Pagamento = Pix: são preenchidas só as colunas de PIX.
• Tipo Pagamento = Transferência ou Depósito: são preenchidas só as colunas de banco, agência e conta.
• Tipo Pagamento = Selecione (não informado): usa PIX se houver chave; se não houver, usa a conta bancária.
• Sem conta cadastrada, ou com Tipo Pix = Dados Bancários: todas estas colunas ficam em branco.
|
Coluna do arquivo |
O que significa |
De onde vem |
Formato / exemplo |
|
cedenteTipoRecebimento |
Forma de recebimento. |
Campo Tipo Pagamento. |
PIX ou TED |
|
cedenteTipoChavePix |
Tipo da chave PIX. |
Campo Tipo Pix: Telefone, E-mail, CPF/CNPJ ou Aleatória. |
TELEFONE, EMAIL, CPF, CNPJ ou ALEATORIA |
|
cedenteChavePix |
Chave PIX da empresa. |
Campo Chave Pix. |
CPF/CNPJ só com números |
|
cedenteBancoCodigo |
Código do banco. |
Campo Banco. |
3 dígitos 001 |
|
cedenteTipoConta |
Tipo da conta. |
Campo Tipo Conta. |
P = Poupança C = Corrente ou Salário |
|
cedenteAgencia |
Número da agência. |
Campo Agência. |
1234 |
|
cedenteDigitoAgencia |
Dígito da agência. |
Campo Dac ao lado de Agência. |
5 |
|
cedenteConta |
Número da conta. |
Campo Conta. |
Só números 123456 |
|
cedenteDigitoConta |
Dígito da conta. |
Campo Dac ao lado de Conta. |
7 |
7.3 Médico prestador
Dados do médico, que é o agente do título. Tela: Cadastros > Agentes > Cad. de Agentes, no cadastro do médico.
|
Coluna do arquivo |
O que significa |
De onde vem |
Formato / exemplo |
|
medicoPrestadorCpf |
CPF do médico. |
Aba Dados, campo CNPJ/CPF. |
Só números 52998224725 |
|
medicoPrestadorNome |
Nome do médico. |
Aba Dados, campo Nome. |
Texto |
|
medicoPrestadorDataNascimento |
Data de nascimento. |
Aba Adicionais > Pessoais, campo Data Nasc. |
01/01/1990 |
|
medicoPrestadorCrm |
Número do CRM. Obrigatório. |
Aba Adicionais > Pessoais, campo CR Numero. |
123456 |
|
medicoPrestadorCrmUf |
Estado do CRM. Obrigatório. |
Aba Adicionais > Pessoais, campo CR Uf. |
SP |
|
medicoPrestadorEmail |
E-mail do médico. |
Aba Dados, bloco Contatos Eletrônicos: o primeiro e-mail preenchido. |
medico@exemplo.com |
|
medicoPrestadorDdd |
DDD do telefone do médico. |
Aba Dados, bloco Telefones: o primeiro telefone preenchido, 2 primeiros dígitos. |
11 |
|
medicoPrestadorTelefone |
Telefone do médico, sem DDD. |
Mesmo telefone acima, sem o DDD. |
999998888 |
7.4 Título
Dados do lançamento no financeiro. A tela do título (Financeiro nr ...) abre, por exemplo, pela aba Financeiro do cadastro do médico.
|
Coluna do arquivo |
O que significa |
De onde vem |
Formato / exemplo |
|
idExterno |
Número do título no sistema. |
Número que aparece no título da tela (Financeiro nr ...). |
50385 |
|
servico |
Código do serviço. |
Não é enviado hoje. |
Sempre em branco |
|
descricao |
Descrição do serviço. |
Campo Observação. |
Plantão de setembro |
|
dataPrestacao |
Data da prestação do serviço. |
Campo Emissão. |
01/09/2026 |
|
valorBruto |
Valor antes de acréscimos e abatimentos. |
Calculado: Valor líquido − Acréscimo + Abatimento. É o mesmo Valor bruto mostrado na tela. |
1500.00 |
|
retencoesGlosas |
Retenções e glosas. |
Não é calculado hoje. |
Sempre 0.00 |
|
valorLiquidoConfirmado |
Valor a pagar. |
Campo Valor líquido. |
1500.00 |
|
vencimento |
Data de vencimento. |
Campo Vencimento. |
30/09/2026 |
7.5 Nota fiscal eletrônica
Dados da NF-e do movimento que gerou o título. Ficam em branco quando o título não veio de um movimento ou quando a nota não tem chave ou não está autorizada.
|
Coluna do arquivo |
O que significa |
De onde vem |
Formato / exemplo |
|
chaveNfe |
Chave de acesso da NF-e. |
Movimento do título, campo Chave Acesso. |
44 dígitos |
|
xmlNfe |
Conteúdo completo do XML da NF-e. |
XML da nota autorizada do movimento (o mesmo do ícone XML ao lado da Chave Acesso). |
Texto do XML |