Para cobrar uma integração de API para um cliente estrangeiro, associe cada etapa a um conjunto verificável de entregas e defina quem pode aprová-las. O marco pode exigir endpoints funcionando em ambiente combinado, teste documentado e entrega de documentação. Uma cobrança clara liga a invoice ao marco e permite explicar o que foi entregue se o cliente contestar o valor.
Defina o que conta como integração concluída
Especifique endpoints, autenticação, volume de testes, mapeamento de erros e dados de exemplo. Combine o ambiente de homologação e quem fornece as chaves. Se a equipe do cliente atrasa o acesso, registre a data e o efeito no cronograma. Separe teste de integração de monitoramento depois que o código entra em produção. Esses serviços podem ter cronogramas e valores diferentes.
Defina o que está incluído em documentação, acesso ao repositório e suporte após entrega. Se você utiliza biblioteca própria, explique a diferença entre os componentes preexistentes e o código produzido para o projeto. A documentação do INPI sobre programas de computador ajuda a localizar as normas relevantes. A redação dos direitos precisa refletir o acordo concreto.
Exemplo de cobrança por marcos
Uma PJ brasileira contrata uma integração de USD 6.000 em três etapas. A primeira entrega o mapeamento da autenticação por USD 1.500. A segunda entrega quatro endpoints testados por USD 3.000. A terceira inclui implantação e documentação por USD 1.500. Cada invoice descreve a etapa correspondente e aponta para a evidência de aceite.
Se o cliente pede um quinto endpoint no meio da segunda etapa, registre a alteração de escopo e estime prazo e preço antes de incluí-lo. Se o teste passa em homologação e a publicação depende do cliente, a cobrança segue a condição prevista para aquele marco. Defina essa situação antes de executar o projeto.
Feche a trilha da cobrança
Guarde contrato, versão do escopo, referência do repositório, relatório de teste, aprovação e invoice. Evite anexar chaves ou dados de produção a documentos de cobrança. Informe à contabilidade a identidade do tomador, o período, o local em que o resultado é utilizado e o comprovante de pagamento.
Modelo de evidência para aprovar cada etapa
Em cada marco, liste as operações que precisam funcionar e o resultado esperado. Para um endpoint de criação de pedido, por exemplo, documente a resposta para pedido válido, dados incompletos e tentativa duplicada. Defina quem fornece os casos de teste e quem tem autoridade para aceitar. Registre também como a equipe avalia erros do ambiente de homologação, pois uma falha de credencial do cliente exige uma ação diferente de um defeito da implementação.
No relatório de entrega, inclua versão do código, data da execução, ambiente e referência dos testes. Quando o cliente usa um portal de compras, coloque a identificação do marco no pedido e na invoice. Guarde um arquivo de evidência com dados de teste anonimizados, sem chaves. Se a aprovação ocorreu em reunião, registre em ata os itens aceitos e os pendentes. Isso oferece uma trilha clara mesmo quando a pessoa que aprova tecnicamente não é a mesma que libera o pagamento.
Um contratante pode pedir que a PJ mantenha um serviço rodando durante 30 dias antes de pagar a etapa. Nesse caso, descreva quais métricas serão observadas e como serão medidas. Separe o aceite da integração das obrigações posteriores de disponibilidade. Se o cliente controla a infraestrutura, delimite quais indisponibilidades dependem dele. Em um projeto por hora, estabeleça também quem valida o apontamento e qual evento permite emitir a cobrança.
Considere o custo de manter ambientes e credenciais após o término. Defina a entrega de documentação, a transferência de acesso e a exclusão de dados de teste. Se o contrato prevê suporte de transição, indique quantidade de horas e canal de atendimento. Um termo de encerramento pode confirmar que os acessos foram revogados e que as últimas pendências já foram tratadas. Esse documento facilita separar cobrança final de demandas posteriores.
Para fechar a invoice do marco, use uma descrição que seja compreensível para compras e para a contabilidade. Em vez de citar apenas o nome interno da sprint, identifique a integração, o período e a referência do aceite. Preserve o valor em moeda original e o comprovante de pagamento. Se o resultado foi usado em uma operação específica do cliente, registre a unidade e o destino da implantação para apoiar a análise do caso.
No primeiro contrato, faça a conferência de cadastro antes de entregar o marco inicial. Confirme se o cliente já tem seus dados bancários, se exige número de pedido e qual formato de documento aceita. Um projeto tecnicamente aprovado pode ficar com cobrança travada por cadastro incompleto.
Perguntas frequentes
Posso cobrar por sprint em vez de endpoint?
Sim, se o contrato definir a prestação e como a cobrança será aprovada. Documente a capacidade ou entrega da sprint e preserve o aceite.
Como tratar acesso ainda indisponível?
Registre a dependência e os impactos. Confirme com o cliente se o prazo, o marco ou o escopo será ajustado.
O aceite precisa ser um documento separado?
Combine a forma de prova. E-mail, portal ou ata podem servir como evidência conforme o acordo, desde que identifiquem o marco aprovado.
Fontes oficiais
Leituras relacionadas
Como a Zen pode ajudar
A contabilidade para exportação de serviços da Zen ajuda a organizar documentos, conciliar recebimentos e analisar as regras da sua operação. Peça uma proposta personalizada para conversar sobre o seu caso.
Tags:
Perguntas Frequentes
"Exporto serviços de consultoria para os EUA e a equipe cuida de toda a parte fiscal e cambial. Economizo muito com a isenção de ISS."
Marina Silva
Consultora Internacional · São Paulo, SP
Contador Especialista em Profissionais de Saúde · Fundador da Contabilidade Zen
Contador especializado em tributação para médicos, dentistas e psicólogos PJ. Registro ativo no CRC-SP (337693/O-7). Fundador da Contabilidade Zen, escritório 100% digital focado em planejamento tributário e abertura de empresa para profissionais de saúde.
