👋 Introdução para Integradores - ecosif-moviments

📋 Bem-vindo!

Este guia é destinado a integradores que desejam consumir a API do serviço ecosif-moviments.

🎯 O que é o ecosif-moviments?

ecosif-moviments é um microserviço responsável pelo gerenciamento de lançamentos contábeis no sistema eCosif. Ele permite:

• ✅ Criar e gerenciar lotes, documentos e lançamentos contábeis
• ✅ Importar arquivos IPL e CSV com movimentações
• ✅ Executar consolidações contábeis
• ✅ Calcular cotas tributárias
• ✅ Controlar períodos contábeis

🔗 Informações Básicas

• Base URL (Desenvolvimento): http://localhost:8082
• Base URL (Produção): https://moviments.ecosif.net.br
• Documentação Swagger: http://localhost:8082/swagger-ui.html
• Formato de dados: JSON
• Autenticação: JWT Bearer Token

📚 Documentação Disponível

• Autenticação - Como obter e usar tokens JWT
• Uso da API - Como fazer requisições
• Exemplos - Exemplos práticos
• Erros Comuns - Troubleshooting

🚀 Quick Start

1. Obter Token de Autenticação

curl -X POST http://localhost:8080/api/auth/signin \
  -H "Content-Type: application/json" \
  -d '{
    "username": "admin",
    "password": "senha123"
  }'

Resposta:

{
  "accessToken": "eyJhbGciOiJIUzI1NiJ9...",
  "tokenType": "Bearer"
}

2. Criar um Lote

curl -X POST http://localhost:8082/batch \
  -H "Authorization: Bearer <seu-token>" \
  -H "Content-Type: application/json" \
  -d '{
    "lote": "001",
    "empresa": "00001",
    "filial": "00001",
    "ano": 2025,
    "mes": 11,
    "descricao": "Lote de Novembro"
  }'

3. Criar um Documento

curl -X POST http://localhost:8082/document \
  -H "Authorization: Bearer <seu-token>" \
  -H "Content-Type: application/json" \
  -d '{
    "batchId": 1,
    "documento": "000001",
    "texto": "Documento de teste"
  }'

4. Criar um Lançamento

curl -X POST http://localhost:8082/entry \
  -H "Authorization: Bearer <seu-token>" \
  -H "Content-Type: application/json" \
  -d '{
    "documentId": 1,
    "lancamento": "001",
    "debcre": "D",
    "day": "15",
    "contaId": 100,
    "valor": 1000.00
  }'

📖 Conceitos Importantes

Hierarquia de Dados

Empresa → Filial → Lote → Documento → Lançamento

Partidas Dobradas

Cada documento deve ter: - Soma de débitos = Soma de créditos

Períodos Contábeis

• Períodos devem estar abertos para receber lançamentos
• Períodos consolidados não podem receber novos lançamentos

📞 Suporte

• Email: support@ecosif.net.br
• Documentação: /docs
• Swagger UI: /swagger-ui.html

Última Atualização: 2025-11-27