POST
/
sales
cURL
curl --request POST \
  --url https://developers.nemu.com.br/api/v1/sales \
  --header 'Authorization: <api-key>' \
  --header 'Content-Type: application/json' \
  --data '{
  "name": "<string>",
  "transactionId": "<string>",
  "netValue": 123,
  "grossValue": 123,
  "status": "<string>",
  "quantity": 123,
  "paymentType": "<string>",
  "utm_source": "<string>",
  "utm_campaign": "<string>",
  "utm_medium": "<string>",
  "utm_content": "<string>",
  "utm_term": "<string>",
  "customerName": "<string>",
  "customerEmail": "<string>",
  "customerPhone": "<string>",
  "date": "2023-12-25",
  "orderCreatedAt": "2023-11-07T05:31:56Z",
  "products": [
    {
      "productId": "<string>",
      "name": "<string>",
      "quantity": 123,
      "netValue": 123,
      "grossValue": 123,
      "priceCost": 123,
      "category": {
        "id": "<string>",
        "name": "<string>",
        "imageUrl": "<string>"
      }
    }
  ],
  "priceCost": 123
}'
Use esta rota para enviar informações de vendas para a Nemu.

​
Exemplo (único produto):

{
  "name": "Nome do produto",
  "transactionId": "123",
  "netValue": 10,
  "grossValue": 30,
  "status": "paid",
  "quantity": 1,
  "paymentType": "pix",
  "utm_campaign": "opcional",
  "utm_content": "opcional",
  "utm_medium": "opcional",
  "utm_source": "opcional",
  "utm_term": "opcional",
  "customerName": "Nome do Cliente",
  "customerEmail": "emaildocliente@gmail.com",
  "customerPhone": "11912345678",
  "date": "2024-06-25",
  "orderCreatedAt": "2024-06-25 00:00:00",
  "priceCost": 5
}

​
Exemplo (múltiplos produtos):

{
  "name": "Nome do pedido",
  "transactionId": "123",
  "netValue": 20,
  "grossValue": 40,
  "status": "paid",
  "quantity": 1,
  "paymentType": "pix",
  "utm_campaign": "opcional",
  "utm_content": "opcional",
  "utm_medium": "opcional",
  "utm_source": "opcional",
  "utm_term": "opcional",
  "customerName": "Nome do Cliente",
  "customerEmail": "emaildocliente@gmail.com",
  "customerPhone": "11912345678",
  "date": "2024-06-25",
  "createdAt": "2024-06-25 00:00:00",
  "products": [
    {
      "productId": "1",
      "name": "Nome do Produto 1",
      "quantity": 1,
      "netValue": 10,
      "grossValue": 20,
      "priceCost": 5,
      "category": {
        "id": "15",
        "name": "categoria 1"
      }
    },
    {
      "productId": "2",
      "name": "Nome do Produto 2",
      "quantity": 1,
      "netValue": 10,
      "grossValue": 20,
      "priceCost": 5
    }
  ]
}

Authorizations

​
Authorization
string
header
required

Token de API gerado no dashboard. Envie no header Authorization sem 'Bearer'. Exemplo: Authorization: 123456abcdef

Body

application/json

Dados da venda ou pedido.

​
name
string
required

Nome do produto ou pedido

​
transactionId
string
required

ID da transação ou pedido

​
netValue
number
required

Valor líquido da transação ou pedido

​
grossValue
number
required

Valor bruto da transação ou pedido

​
status
string
required

Status da transação ou pedido (paid, waiting_payment, cancelled, chargeback, refunded, checkout_completed)

​
quantity
number
required

Quantidade vendida

​
paymentType
string
required

Método de pagamento (pix, billet, credit_card, other)

​
customerName
string
required

Nome do comprador

​
customerEmail
string
required

Email do comprador

​
customerPhone
string
required

Número de celular ou telefone do comprador

​
date
string<date>
required

Data de criação do pedido (YYYY-MM-DD)

​
orderCreatedAt
string<date-time>
required

Data e hora de criação do pedido em UTC (YYYY-MM-DD HH:MM:SS UTC)

​
products
object[]
required

Lista de produtos do pedido

​
utm_source
string

Parâmetro utm_source (opcional)

​
utm_campaign
string

Parâmetro utm_campaign (opcional)

​
utm_medium
string

Parâmetro utm_medium (opcional)

​
utm_content
string

Parâmetro utm_content (opcional)

​
utm_term
string

Parâmetro utm_term (opcional)

​
priceCost
number

Preço de custo do produto/pedido

Response

Venda criada com sucesso.