POST /tmwxdapi/setOrder
Cria ou altera um pedido. Se o campo id
for informado, o pedido será alterado. Caso contrário,
o sistema tentará criar um novo pedido.
Os campos da requisição abaixo marcados como required, somente são obrigatórios
em caso de criação de novo pedido (quando id
não é informado). Se for uma alteração, basta
informar os campos id
e plataforma
e os campos que serão alterados.
plataforma
.
plataforma
deverá conter o IP do cliente que fez a compra. Você pode
obter essa informação com o recurso getOrders. Isso é necessário para haver segurança nas alterações.
true
o sistema não enviará emails para o cliente referente ao pedido que está sendo
criado/alterado
codRastreio
e nf
status
Enviado.
status
Enviado.
- num char(9) required
Número da NF.- serie char(2) required
Série da NF.- chave char(44) required
Chave da NF.- data datetime(Y-m-d H:i:s) required
Data de emissão da NF.- urlNFe char(200)
URL para o XML da NFe.- urlDANFE char(200)
URL para a DANFE.
id
.
Caso seja um cliente novo, informe pelo menos os campos obrigatórios.
- id int
ID do cliente. Se informado, os demais campos abaixo serão ignorados.- nome char(100) required
Nome do cliente.- email char(100) required
Email principal (de login) do cliente.- pass char(10)
Senha do cliente, mínimo de 6 caracteres. Se omitida, ou inválida, o cliente receberá uma senha aleatória que poderá ser resgatada depois pelo formulário "Esqueci minha senha" na loja.- pessoa char(3) required
Declare FIS para pessoa Física, ou JUR para pessoa Jurídica.- tipo char(10)
Tipo de consumo. Pode ser Consumidor (padrão se omitido) ou Revenda.- cpfCnpj char(18) required
CPF ou CNPJ do cliente, de acordo com o que for informado empessoa
.- rgIe char(25) required
RE ou IE do cliente, de acordo com o que for informado empessoa
.- sexo char(1)
Pode ser F ou M.- dataNF date(Y-m-d)
Data de nascimento ou fundação.- tel char(15)[(99) 9999-99999] required
Telefone principal.- cel char(15)[(99) 9999-99999]
Celular do cliente.- cep int required
CEP do cliente. Apenas números. Por exemplo, para o CEP05271-160
informe5271160
.- logradouro char(250) required
Rua, avenida ou travessa.- num char(5) required
Número da casa.- comp char(100)
Complemento/Referência.- bairro char(100) required
Bairro.- cidade char(50) required
Cidade.- uf char(2) required
Estado.
pessoa
for JUR
, este campo passa a ser
required.
pessoa
for JUR
, este campo passa a ser
required.
cliente
for o mesmo que o de entrega, não
é necessário informar.
- cep int required
CEP da entrega. Apenas números. Por exemplo, para o CEP05271-160
informe5271160
.- logradouro char(250) required
Rua, avenida ou travessa.- num char(5) required
Número da casa.- comp char(100)
Complemento/Referência.- bairro char(100) required
Bairro.- cidade char(50) required
Cidade.- uf char(2) required
Estado.- recebedor char(50)
Nome do recebedor se for diferente do nome do cliente.- tel char(15)[(99) 9999-99999]
Telefone do recebedor se for diferente do nome do cliente.
parcelasQtde
e
parcelasValor
.
parcelasValor
.
formaPgto
for do tipo cartão, este campo torna-se
required.
formaPgto
for do tipo cartão, este campo torna-se
required.
- id int required
ID do frete a ser usado. Ele pode ser obtido utilizando o recurso calculateShipping.- valor decimal(10,2) required
Valor do frete. Informe 0 (zero) para frete grátis.- prazo int required
Prazo do frete em dias.
object
- id int required
ID do produto. Ele pode ser obtido utilizando o recurso getProducts.- conId char(100)
ID do Conjunto de Variações. Ele pode ser obtido utilizando o recurso getProducts.- qtde int required
Quantidade de peças.- valor decimal(10,2) required
Valor da unidade do item no momento da compra.
POST /tmwxdapi/setOrder Dados vindos da API na Loja Modelo Acesse o Teste: Runscope Request (JSON): { "plataforma": "177.67.159.205", "id": 1123, "status": "Enviado", "codRastreio": "DM534105512BR", "nf": { "num": 123456, "serie": 1, "chave": "11112222333344445555666677778888999900001111", "data": "2017-03-27 18:30" }, "obs": "<p>Alteração de Teste</p>" }
Response (JSON): { "status":true, "pedido":"1123", "erros":[] }