ENVIAR_TODOS_USUARIOS

Envia todos os usuários (operadores/vendedores) cadastrados no ERP para a Maggu. Usado na sincronização inicial ou quando uma re-sincronização completa é necessária.

Argumentos: nenhum

Comando tipo: sem argumentos

Payload recebido

{
  "id": 5001,
  "tipo": "ENVIAR_TODOS_USUARIOS",
  "argumentos": {},
  "criadoEm": "2026-05-13T10:00:00Z"
}

Implementação

def enviar_todos_usuarios(cmd):
    usuarios = erp.buscar_todos_usuarios()

    session.post("api/v3/comandos/iniciou", json={"id": cmd["id"], "total": len(usuarios)})

    for lote in chunk(usuarios, 400):
        session.post("api/v3/usuarios/registrar-em-lote", json={"comandoId": cmd["id"], "conteudo": lote})

Chamada à API Maggu

POST /v3/usuarios/registrar-em-lote

{
  "comandoId": 5001,
  "conteudo": [
    {
      "codigoExterno": "USR-001",
      "nome": "João Silva",
      "cpf": "123.456.789-00",
      "email": "joao@farmacia.com"
    }
  ]
}

Campo	Tipo	Obrigatório	Descrição
codigoExterno	string	Sim	Identificador do usuário no ERP — chave de idempotência
nome	string	Sim	Nome completo
cpf	string	Não	CPF do usuário
email	string	Não	E-mail

Respostas:

Código	Significado
202 Accepted	Lote em processamento
400 Bad Request	Erro de validação
403 Forbidden	Token inválido