Criação automática de usuário e endereço via payload do pedido

Agora é possível enviar os dados completos de usuário e endereço diretamente no corpo da requisição de criação de pedido, sem a necessidade de realizar cadastros prévios.
Essa melhoria reduz a complexidade na integração de grandes operações, tornando o processo de envio de pedidos mais simples, rápido e confiável. [Leia mais]

🧾 Como era antes?

Para um pedido ser criado com sucesso via API, era obrigatório:

• Enviar o usuarioId já previamente cadastrado.
• Enviar o enderecoId previamente associado a esse usuário.

Isso obrigava as integrações a realizarem múltiplas chamadas antes de conseguir inserir um pedido completo — um desafio principalmente para clientes com sistemas de e-commerce proprietários.

✅ O que mudou?

Agora, e usuarioId e/ou enderecoId não forem enviados, a API verifica se os objetos usuario e endereco estão preenchidos no payload.

Caso estejam, a plataforma realiza automaticamente o cadastro do usuário e do endereço antes de inserir o pedido.

A criação segue as regras de aprovação da loja (ex: aprovação automática ou manual).

Tudo ocorre de forma transparente, reduzindo a fricção na integração via API.

🧪 Exemplo de payload com criação automática de usuário e endereço

{
  "situacaoPedidoId": 2,
  "data": "2025-05-14T19:33:37.913Z",
  "valorTotal": 1000,
  "produtos": [
    {
      "produtoVarianteId": 286842,
      "quantidade": {
        "quantidadeTotal": 1,
        "quantidadePorCentroDeDistribuicao": [
          {
            "centroDistribuicaoId": 25,
            "quantidade": 1
          }
        ]
      },
      "precoVenda": 1000.00
    }
  ],
  "pagamento": {
    "formaPagamentoId": 200,
    "numeroParcelas": 1,
    "valorParcela": 1000.00
  },
  "usuario": {
    "tipoPessoa": "Fisica",
    "nome": "Alex Teste",
    "cpf": "49259825083",
    "email": "[email protected]",
    "telefoneCelular": "(31)91020-3040"
  },
  "endereco": {
    "nomeEndereco": "Endereco Teste",
    "rua": "Rua ABC",
    "numero": "100",
    "bairro": "Centro",
    "cidade": "Belo Horizonte",
    "estado": "MG",
    "cep": "30130003",
    "pais": "Brasil"
  }
}

📘

Nota técnica

Caso o objeto usuario seja enviado no payload, não deve ser enviado um enderecoId separado.
Isso porque o endereço precisa estar vinculado ao novo usuário que será criado — e, portanto, o objeto endereco também deve ser enviado junto, permitindo o vínculo correto durante a criação automática.

📚 Documentação

Confira como utilizar essa funcionalidade na documentação oficial da API de pedidos.