> ## Documentation Index
> Fetch the complete documentation index at: https://reportana.dev/llms.txt
> Use this file to discover all available pages before exploring further.
# Create/Update Order
> Use this endpoint to create an order.
Use this endpoint to **create or update** an order in your Reportana store. The `reference_id` attribute is required and must correspond to the `id` or unique identifier of the order in your system, ensuring proper association between your system's data and our platform.
## Headers
Basic base64(client\_id + ':' + client\_secret)
Content-Type:application/json
## Body
Enter the reference ID.
Example: "123456789".
Enter the order number.
Example: "1234".
Enter the admin panel URL for accessing the order.
Example: "[https://example.com/admin/orders/123456789](https://example.com/admin/orders/123456789)".
Enter the customer’s name.
Example: "John Doe".
Enter the customer’s phone number.
Example: "+5511911111111".
Enter the customer’s email address.
Example: "[johndoe@gmail.com](mailto:johndoe@gmail.com)".
Enter the customer’s document number.
Example: "123456789".
### Billing Adress
Enter the billing address information.
Enter the customer's name.
Example: "John Doe".
Enter the customer's first name.
Example: "John".
Enter the customer's last name.
Example: "Doe".
Enter the company name.
Example: "John Doe Ltda".
Enter the customer's phone number.
Example: "+5511911111111".
Enter the customer's address.
Example: "6925 Hollywood Blvd".
Enter the customer's neighborhood.
Example: "Times Square".
Enter the customer's city.
Example: "New York".
Enter the customer's state.
Example: "North Carolina".
Enter the customer's state code.
Example: "NC".
Enter the customer's country.
Example: "United States of America".
Enter the customer's country code.
Example: "USA".
Enter the customer's ZIP code.
Example: "90213".
Enter the customer's latitude.
Example: -27.807915923881836
Enter the customer's longitude.
Example: -50.3183162423294
### Shipping Adress
Enter the shipping address information.
Enter the customer's name.
Example: "John Doe".
Enter the customer's first name.
Example: "John".
Enter the customer's last name.
Example: "Doe".
Enter the company name.
Example: "John Doe Ltda".
Enter the customer's phone number.
Example: "+5511911111111".
Enter the customer's address.
Example: "6925 Hollywood Blvd".
Enter the customer's neighborhood.
Example: "Times Square".
Enter the customer's city.
Example: "New York".
Enter the customer's state.
Example: "North Carolina".
Enter the customer's state code.
Example: "NC".
Enter the customer's country.
Example: "United States of America".
Enter the customer's country code.
Example: "USA".
Enter the customer's ZIP code.
Example: "88508100".
Enter the customer's latitude.
Example: -27.807915923881836
Enter the customer's longitude.
Example: -50.3183162423294
### Line Items
Click on "Add an item" to add a product.
Enter the product title.
Example: "Sunglasses".
Enter the product variant title.
Example: "Black".
Enter the quantity of products in the order.
Example: 1
Enter the product price.
Example: 49.9
Enter the public access URL of the product.
Example: "[https://example.com/products/1234](https://example.com/products/1234)".
Enter the product image URL.
Example: "[https://example.com/products/1234/image.jpg](https://example.com/products/1234/image.jpg)".
Enter the product tracking number.
Example: "LB123456789BR".
### Payment & More Info
Enter the currency used.
Example: "USD".
Enter the total amount.
Example: 124.8
Enter the subtotal amount.
Example: 109.8
Enter the payment status.
Example: "PAID".
Available options: `PAID`, `PENDING`, `NOT_PAID`.
Enter the payment method.
Example: "CREDIT\_CARD".
Available options: `CREDIT_CARD`, `PIX`, `DEPOSIT`, `BOLETO`, `OTHER`.
Enter the order tracking numbers.
Example: "LB123456789BR,LB987654321BR".
Enter the site URL.
Example: "[https://www.facebook.com/](https://www.facebook.com/)".
Enter the order status URL.
Example: "[https://example.com/orders/123456789](https://example.com/orders/123456789)".
Enter the payment URL.
Example: "[https://example.com/orders/123456789/creditcard.pdf](https://example.com/orders/123456789/creditcard.pdf)".
Enter the billet barcode or Pix “Copy and Paste” string.
Enter the payment expiration date.
Example: "2022-05-31".
Enter the order creation date.
Example: "2022-05-27 12:00".
```json 200 theme={null}
{
"success": true,
"data": null
}
```
```json 4XX theme={null}
{
"success": false,
"message": "Check the required fields.",
"errors": {
"reference_id": [
"The reference_id field is required."
],
"number": [
"The number field is required."
],
"customer_name": [
"The customer_name field is required."
],
"customer_email": [
"The customer_email field is required."
],
"customer_phone": [
"The customer_phone field is required."
],
"currency": [
"The currency field is required."
],
"total_price": [
"The total_price field is required."
],
"subtotal_price": [
"The subtotal_price field is required."
],
"original_created_at": [
"The original_created_at field is required."
]
}
}
```