Configuração Uyumsoft e-Fatura

O Convord se comunica com a Uyumsoft usando requisições JSON para BasicIntegrationApi para e-Fatura / e-Arquivo e, opcionalmente, DespatchApi para e-Remessa. A autenticação segue os exemplos oficiais: cada requisição inclui userInfo com Username e Password. Não há fluxo OAuth nem chave API separada; o que você informa no painel é exatamente esse par.

Configurar no painel

1. Ative faturamento em Configurações → Integrações.
2. Escolha Uyumsoft como provedor de fatura.
3. Preencha o ID fiscal (VKN/TCKN) e a repartição fiscal da empresa; devem corresponder à sua conta Uyumsoft.
4. Informe o usuário de integração e a senha de integração fornecidos pela Uyumsoft e salve.
5. Garanta que os clientes faturados tenham VKN (10 dígitos) ou TCKN (11 dígitos) válidos; caso contrário, o envio é bloqueado com mensagem clara.

Chave API vs usuário / senha

A integração usa o objeto REST userInfo. Os dois campos no Convord correspondem a Username e Password. Não há campo extra de Bearer token ou secret key.

Opcionalmente, defina UYUMSOFT_USERNAME / UYUMSOFT_PASSWORD no .env do servidor como fallback tenant-wide; valores específicos da empresa no painel têm precedência quando presentes.

Configurações do servidor (.env)

Hosting / DevOps deve verificar:

• UYUMSOFT_BASE_URL — ex.: produção https://efatura.uyumsoft.com.tr/api ou teste https://efatura-test.uyumsoft.com.tr/api (combinado com configurações de caminho em config).
• URLs completas opcionais: UYUMSOFT_INVOICE_API_URL, UYUMSOFT_DESPATCH_API_URL.
• Smoke test após deploy: php artisan uyumsoft:test

Número fiscal do cliente

Um ID fiscal válido do comprador é necessário para envio Uyumsoft. O Convord valida antes de criar/enviar e exibe erro explícito; atualize o registro do cliente e tente novamente.

e-Remessa (DespatchApi)

O modo local PDF/XML de remessa não exige flags extras no servidor. e-Remessa real Uyumsoft / GİB precisa de:

• EINVOICE_PROVIDER=uyumsoft
• UYUMSOFT_DISPATCH_ENABLED=true — VKN/TCKN do comprador também é obrigatório neste modo.

Conta Uyumsoft e série de fatura

Mesmo com API corretamente configurada, seu projeto Uyumsoft deve ter <strong>série / prefixo</strong> de fatura e configurações de conta concluídas. Caso contrário, você pode ver erros como série ausente. Entre em contato com o suporte Uyumsoft para configuração da conta.

Ambiente de teste

Use a documentação Uyumsoft para URLs de teste e credenciais de amostra. O comando Artisan uyumsoft:test faz smoke test de conectividade BasicIntegrationApi.

Mais informações

Para contexto mais amplo de integração, consulte o Guia de integração.