Number of APIs: 1126
Stop wasting time in developing integrations with every ecommerce system, make a single development with Ecart API and integrate your software with more than 40 ecommerces API's. Ecart API is a great tool for developers looking to integrate their apps with ecommerce platforms fast. We take care of keeping every API fully secure and updated. We offer a 99.9% of uptime and 24/7 support via email: hello@ecartapi.com
LINK https://oauth.ecartapi.com/RrAolcPw8lUYff7h8JEEnJ7sy3usAYlZ
The key to start using EcartAPI is our integration page. This is where the store owners will give us access to their information.
In this page we understand is crucial to be able to transform it into your own so we give you the options and tools to fully white label this view.
On your Dashboard under my apps you can create or edit your apps.
Setup your App name and Logo
The name of your app will appear at the top of the page if you choose to upload your logo or an image it will also apper there.
Go to your App set up page and scroll to Advanced Settings.
Input the new domain and Save it.
Receive a Cname unique to your app.
Set up the cname on your DNS.
Shopify.
Mercadolibre.
Kometia.
Ebay.
Wix.
Tradegecko.
Zoho.
3dCart.
Bigcommerce.
Vendhq.
Salesforce.
Tiendanube.
Jumpseller.
Squarespace.
Amazon.
Etsy.
Ecwid.
Find listed all the parameters you can send when loading your integration page to give a better experience.
Test them right now here:
https://oauth.ecartapi.com/RrAolcPw8lUYff7h8JEEnJ7sy3usAYlZ
GET https://api.ecartapi.com/apps
Get all the APPs you have in your account.
GET https://api.ecartapi.com/apps/{{appId}}
Get the details of an APP.
GET https://api.ecartapi.com/ecommerces
Get a list of supported E-commerce platforms.
DELETE https://api.ecartapi.com/apps/:appId/accesses
This call will delete the store access that you send in the header authorization.
It's required to send the App Id of the app where the store was created.
Possible response satus codes
Status | Message | Description |
---|---|---|
200 | Success | Token has been succesfully deleted |
404 | The access token does not belong to this app. | The access token attempted to be deleted does not belong to the App id provided in the parameters |
404 | The App does not exist. | The app provided in the parameters does not exist |
401 | Invalid token | Token provided to delete does not exist |
401 | Token has been deleted | Token provided to delete has already been deleted |
401 | Token is inactive | Token provided has been deactivated |
GET https://api.ecartapi.com/accesses/me/{{shop_id}}
Use the shop_id
returned in the redirect_url and your client_id as an authorization header to collect the information.
This is a time sensitive request after a user has completed the integration flow and has been redirected to your app. You have 1 minute to fetch the store information. If you fail to fetch the information in the time limit the user will have to do the integration process again.
On your redirect URL you will receive a key
parameter.
The key parameter contains the integrated_at
as an ISO 8601 String parameter encrypted as a Hash with a sha256 algorithm encoded to base64.
Javascript example using the crypto library.
const crypto = require('crypto');
let secretKey = client_id;
//eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJpc3MiOiJOV1poWkRWaVkyVmlNV0U1WkRBd01EQTBZMk5tTm1KaCIsImlhdCI6MTYzMjE3MDY4MjAzOX0.tOEUetiN-fJ-iIYoUVIB2Rj5c2LZdZ62bBfBvP0n9Rw
let integrated_at = store.integrated_at;
//2022-01-31T19:38:24.409Z
let hash = crypto.createHmac('sha256', secretKey).update(String(new Date(integrated_at).toISOString()), 'utf8').digest('base64')
console.log(hash)
//7cu2wjG5+tghmdKQta8Rncp03YleO48N4pTRyETUpS4=
GET https://api.ecartapi.com/api/v2/orders
Note:
Filters are available depending of the ecommerce
GET https://api.ecartapi.com/api/v2/orders/count
GET https://api.ecartapi.com/api/v2/orders/{{id}}
Searches for a selected order and shows the detailed information.
Important information:
POST https://api.ecartapi.com/api/v2/orders
Creates new orders.
Important information:
PUT https://api.ecartapi.com/api/v2/orders/{{id}}
Update an order's information.
Important information:
DELETE https://api.ecartapi.com/api/v2/orders/{{id}}
Permanently deletes the selected order.
Important information:
POST https://api.ecartapi.com/api/v2/orders/{{id}}/cancel
GET https://api.ecartapi.com/api/v2/products
Request used to obtain all the products in a store catalog.
Find a general representation of all the filters and information EcartAPI can abet.
GET https://api.ecartapi.com/api/v2/products/count
GET https://api.ecartapi.com/api/v2/products/{{id}}
Searches for a selected product and shows the detailed information.
Important information:
GET https://api.ecartapi.com/api/v2/products/{{productId}}/variants
Searches for all the registered variants of a single product.
Important information:
Filter | Description |
limit |
Limit size of the search. |
page |
Pagination number. |
sinceId |
Filter items since the Id given. |
offset |
Lower limit of the results block. Modifies the range of the results provided, range goes from offset to limit. |
GET https://api.ecartapi.com/api/v2/products/{{productId}}/variants/{{id}}
Searches for the selected variant and shows the detailed information.
Important information:
GET https://api.ecartapi.com/api/v2/products/{{productId}}/variants/count
Counts all the registered variants of a single product.
Important information:
GET https://api.ecartapi.com/api/v2/products/{{productId}}/images
Searches for all the images of a single product.
Important information:
Filter | Description |
sinceId |
Filter items since the Id given |
GET https://api.ecartapi.com/api/v2/products/{{productId}}/images/{{id}}
Searches for the selected image of a product.
Important information:
POST https://api.ecartapi.com/api/v2/products
POST https://api.ecartapi.com/api/v2/products/{{productId}}/variants
Creates a variation of an available product.
Important information:
POST https://api.ecartapi.com/api/v2/products/{{productId}}/images
Adds a new image to an existing product.
Important information:
PUT https://api.ecartapi.com/api/v2/products/{{id}}
Updates the product information, according to new detailed information.
Important information:
PUT https://api.ecartapi.com/api/v2/products/{{productId}}/variants/{{id}}
Updates the information of an already existing product variant
Important information:
DELETE https://api.ecartapi.com/api/v2/products/{{id}}
Permanently delete the selected product.
Important information:
DELETE https://api.ecartapi.com/api/v2/products/{{productId}}/variants/{{id}}
Permanently deletes a product's variation.
Important information:
DELETE https://api.ecartapi.com/api/v2/products/{{productId}}/images/{{id}}
Permanently deletes the selected image of a product.
Important information:
GET https://api.ecartapi.com/api/v2/products/listings
GET https://api.ecartapi.com/api/v2/products/listings/{{id}}
GET https://api.ecartapi.com/api/v2/categories
Searches for all the available categories.
Filter | Description |
ids |
Filter categories by the ids given |
limit |
Limit size of the search |
page |
Pagination number. |
sinceId |
Filter categories since the Id given |
name |
Filter categories by name |
productId |
Filter categories by product id |
siteId |
Filter items by site id |
offset |
Lower limit of the results block. Modifies the range of the results provided, range goes from offset to limit |
GET https://api.ecartapi.com/api/v2/categories/count
GET https://api.ecartapi.com/api/v2/categories/{{id}}
Searches for the selected category and shows detailed information.
Important information:
POST https://api.ecartapi.com/api/v2/categories
Creates a new category.
PUT https://api.ecartapi.com/api/v2/categories/{{id}}
Actualize the selected category information.
Important information:
DELETE https://api.ecartapi.com/api/v2/categories/{{id}}
Permanently deletes the selected category.
Important information:
GET https://api.ecartapi.com/api/v2/customers
Filter | Description |
ids |
Filter cutomers by Id's provided |
limit |
Limit size of the search |
page |
Pagination number. |
sinceId |
Filter customers since the Id given |
createdAt[from] |
Filter customers by date created from. When used createdAt[to] Required |
createdAt[to] |
Filter customers by date created to. When used createdAt[from] Required |
updatedAt[from] |
Filter customers by date updated from. When used updatedAt[to] Required |
updatedAt[to] |
Filter customers by date updated to. When used updatedAt[from] Required |
name |
Filter categories by name |
search |
Search by string |
email |
Search customers by email |
offset |
Lower limit of the results block. Modifies the range of the results provided range goes from offset to limit |
GET https://api.ecartapi.com/api/v2/customers/count
GET https://api.ecartapi.com/api/v2/customers/{{id}}
Searches for the selected customer and shows detailed information.
Important information:
POST https://api.ecartapi.com/api/v2/customers
Registers a new costumer.
Important information:
PUT https://api.ecartapi.com/api/v2/customers/{{id}}
Update the selected costumer's information.
Important information:
DELETE https://api.ecartapi.com/api/v2/customers/{{id}}
Permanently deletes the selected customer.
Important information:
GET https://api.ecartapi.com/api/v2/carts
GET https://api.ecartapi.com/api/v2/carts/{{id}}
PUT https://api.ecartapi.com/api/v2/carts/{{id}}
GET https://api.ecartapi.com/api/v2/orders/{{orderId}}/fulfillments
Shows all of the order's fulfillments detailed.
Important information:
GET https://api.ecartapi.com/api/v2/orders/{{orderId}}/fulfillments/{{id}}
Shows a selected order fulfillment with detail.
Important information:
PUT https://api.ecartapi.com/api/v2/orders/{{orderId}}/fulfillments/{{id}}
Update the fulfillment information.
Important information:
POST https://api.ecartapi.com/api/v2/orders/{{orderId}}/fulfillments
This request creates a fulfillment on an Order
The items array is optional it can be send on selected ecommerces to create partial fulfillments, if you want to make a complete fulfillment just skip sending this information and the fulfillment information will be applied to all the items in the order.
This API request has a feature that some ecommerces support, which allows to send the items of the order you choose to be fulfilled allowing for partial fulfillments. (THIS IS ONLY ON SELECTED ECOMMERCES REVIEW THE SUPPORTED REQUESTS BY CART FOLDER TO SEE IF THE ECOMMERCE YOU ARE USING ALLOWS THIS FEATURE)
We recommend that if you are going to be making this request to all of the ecommerces we offer to follow this payload as it has all the required information of the overall ecommerce's.
If you are only going to be working with a selected few ecommerce we recommend to go to our Supported Requests By Cart folder and using the payload from the ecommerce you choose to work with.
Important information:
The order's ID must exist
POST https://api.ecartapi.com/api/v2/orders/{{orderId}}/fulfillments/{{id}}/cancel
Cancels an order's fulfillment.
Important information:
OPTIONS https://api.ecartapi.com/api/v2/webhooks
GET https://api.ecartapi.com/api/v2/webhooks
GET https://api.ecartapi.com/api/v2/webhooks/{{id}}
POST https://api.ecartapi.com/api/v2/webhooks
PUT https://api.ecartapi.com/api/v2/webhooks/{{id}}
DELETE https://api.ecartapi.com/api/v2/webhooks/{{id}}
GET https://api.ecartapi.com/api/v2/cupons
GET https://api.ecartapi.com/api/v2/cupons/{id}
POST https://api.ecartapi.com/api/v2/cupons
PUT https://api.ecartapi.com/api/v2/cupons/1133821526185
DELETE https://api.ecartapi.com/api/v2/cupons/{id}
GET https://api.ecartapi.com/api/v2/cupons/{cuponsId}/discountCodes
GET https://api.ecartapi.com/api/v2/cupons/{cuponId}/discountCodes/{id}
POST https://api.ecartapi.com/api/v2/cupons/{cuponsId}/discountCodes
PUT https://api.ecartapi.com/api/v2/cupons/{cuponId}/discountCodes/{id}
DELETE https://api.ecartapi.com/api/v2/cupons/{cuponId}/discountCodes/{id}
POST https://api.ecartapi.com/api/v2/services/woocommerce/connect/status
LINK CARRIER_CALLBACK_URL
Everytime there is a user in the checkout of the ecommerce store you will get the following payload.
{
"origin": {
"name": "TestingPruebas",
"company": "EcartAPI",
"email": "admin@ecartapi.com",
"phone": "81111111111",
"street": "Florencio Varela",
"number": "2471",
"district": null,
"city": "San Justo",
"state": "Buenos Aires",
"country": "AR",
"postalCode": "1754"
},
"destination": {
"name": " ",
"company": "EcartAPI",
"email": "admin@ecartapi.com",
"phone": "81111111111",
"street": "street",
"number": "1",
"district": "General San Martin",
"city": "General San Martin",
"state": "Buenos Aires",
"country": "AR",
"postalCode": "5012"
},
"items": [
{
"name": "Productito",
"sku": "PKNTO1",
"quantity": "1",
"price": "50",
"weight": "1",
"width": 10,
"height": 10,
"depth": 10,
"productId": "123530131",
"variantId": null
}
],
"package": {
"content": null,
"amount": "1",
"type": "box",
"dimensions": {
"length": 10,
"width": 10,
"height": 10
},
"weight": "1",
"lengthUnit": null,
"weightUnit": null,
"insurance": "0",
"declaredValue": "0"
},
"currency": "MXN",
"locale": null
}
LINK RESPONSE
When Ecartapi requests shipping rates from your callback URL the response must be a an array that contains the following information.
There are two kinds carrier services can offer, shipping and pickup.
When sending shipping options the payload should contain the following information
[
{
"carrier": "oca",
"service": "oca_PP",
"serviceDescription": "Oca Puerta a Puerta",
"pickUp": false
"deliveryEstimate": "2-4 días",
"deliveryDate": {
"date": "2022-08-14",
"time": "13:01",
"dateDifference": 4,
"timeUnit": "days"
},
"totalPrice": 182.72,
"currency": "MXN"
}
]
When sending pick up options the payload should contain the following information.
(THE PICK UP OPTIONS ARE ONLY AVAILABLE FOR TIENDANUBE).
[
{
"carrier": "oca",
"service": "oca_PS",
"serviceDescription": "Oca Puerta a Sucursal",
"pickUp": true,
"deliveryEstimate": "1-3 días",
"deliveryDate": {
"date": "2022-08-13",
"time": "13:01",
"dateDifference": 3,
"timeUnit": "days"
}
"totalPrice": 124.9,
"currency": "MXN",
"branches": [
{
"branch_id": 75,
"branch_code": "NIC",
"reference": "SAN NICOLAS",
"address": {
"address": "ESPAÑA",
"number": "280",
"phone": "8111111111",
"zipcode": "2900",
"locality": "SAN NICOLAS",
"province": "BUENOS AIRES",
"country": "AR"
},
"hours": [
{
"day": 1,
"start": "0900",
"end": "1700"
},
{
"day": 2,
"start": "0900",
"end": "1700"
},
{
"day": 3,
"start": "0900",
"end": "1700"
},
{
"day": 4,
"start": "0900",
"end": "1700"
},
{
"day": 5,
"start": "0900",
"end": "1700"
}
]
},
{
"branch_id": 129,
"branch_code": "SPD",
"reference": "SAN PEDRO",
"address": {
"address": "OLIVEIRA CEZAR",
"number": "25",
"phone": "8111111111",
"zipcode": "2930",
"locality": "SAN PEDRO",
"province": "BUENOS AIRES",
"country": "AR"
},
"hours": [
{
"day": 1,
"start": "0900",
"end": "1700"
},
{
"day": 2,
"start": "0900",
"end": "1700"
},
{
"day": 3,
"start": "0900",
"end": "1700"
},
{
"day": 4,
"start": "0900",
"end": "1700"
},
{
"day": 5,
"start": "0900",
"end": "1700"
}
]
},
{
"branch_id": 1253,
"branch_code": "VCO",
"reference": "CI VILLA CONSTITUCIÓN",
"address": {
"address": "IRIGOYEN",
"number": "201",
"phone": "8111111111",
"zipcode": "2919",
"locality": "VA.CONSTITUCION",
"province": "SANTA FE",
"country": "AR"
},
"hours": [
{
"day": 1,
"start": "0900",
"end": "1700"
},
{
"day": 2,
"start": "0900",
"end": "1700"
},
{
"day": 3,
"start": "0900",
"end": "1700"
},
{
"day": 4,
"start": "0900",
"end": "1700"
},
{
"day": 5,
"start": "0900",
"end": "1700"
}
]
}
]
}
]
GET https://api.ecartapi.com/api/v2/services/carriers
GET https://api.ecartapi.com/api/v1/services/carriers/{{id}}
POST https://api.ecartapi.com/api/v2/services/carriers
Request that creates a shipping carrier service.
Carrier service create properties.
Attributes | Meaning |
---|---|
name(String) | Name that will represent your service on the seller store. |
url(String) | URL where you will receive the live quotation requests. |
settings(Object) | Settings that modify the response the ecommerce will receive. See table A for more information. |
TABLE A
Attributes inside the settings object
Attributes | Meaning |
---|---|
hideDeliveryDate (String/Boolean) | Default is false . Choose if the delivery expected dates will appear on the check out page. |
PUT https://api.ecartapi.com/api/v2/services/carriers/{{id}}
Request that updates a shipping carrier service.
Carrier service update properties.
Attributes | Meaning |
---|---|
name(String) | Name that will represent your service on the seller store. |
url(String) | URL where you will receive the live quotation requests. |
settings(Object) | Settings that modify the response the ecommerce will receive. See table A for more information. |
TABLE A
Attributes inside the settings object
Attributes | Meaning |
---|---|
hideDeliveryDate (String/Boolean) | Default is false . Choose if the delivery expected dates will appear on the check out page. |
DELETE https://api.ecartapi.com/api/v2/services/carriers/{{id}}
GET https://api.ecartapi.com/api/v2/services/fulfillment
GET https://api.ecartapi.com/api/v2/services/fulfillment/{{id}}
POST https://api.ecartapi.com/api/v2/services/fulfillment
PUT https://api.ecartapi.com/api/v2/services/fulfillment/{{id}}
DELETE https://api.ecartapi.com/api/v2/services/fulfillment/{{id}}
POST https://api.ecartapi.com/api/v2/services/fulfillment/accepted/1krHpAcxy0vfsxKN1632263146360
POST https://api.ecartapi.com/api/v2/services/fulfillment/rejected/1krHpAcxy0vfsxKN1632263146360
GET https://api.ecartapi.com/api/v2/orders/services/fulfillment?status[status]=fulfillment_requested/cancellation_requested
GET the_url_of_the_fulfillmentService/fetch_stock?sku=10551
You will receive a request from shopify every 10-5 min or whenever a store asigns an item to your location.
You have to return a response payload following the examples.
GET https://api.ecartapi.com/accesses/me
Access store information fast with the access token we provided.
DELETE https://api.ecartapi.com/api/v2/services/access/delete
Has a user uninstalled your app?
Remove the integration with a single request; we will delete all the services related to the store webhooks, carriers, etc.
LINK https://api.ecartapi.com/api/v2/webhooks/shopify/callback/{{gdprReference}}/{{webhook_type}}
Requirements:
Before we start setting up the Shopify GDPR webhooks first you need to already have all of the following:
A Shopify access token.
An App in Shopify's Partner program.
An Endpoint on your app to receive webhook information.
Setting Up Webhooks on EcartAPI:
Create the 3 types of GDPR webhooks through EcartAPI using a POST request. Make sure to save the gdprReference
for each webhook.
Set up your GDPR URL for Shopify as follows:
- URL format: `https://api.ecartapi.com/api/v2/webhooks/shopify/callback/{{gdprReference}}/{{webhook_type}}`
- Replace the information within the double curly braces `{{ }}` with the appropriate values:
- `{{gdprReference}}` with the `gdprReference` you saved in step 1.
- `{{webhook_type}}` with the specific type of GDPR webhook ("customer_request", "customer_data_exported", "", etc.).
Now, let's proceed to configure these webhooks in your Shopify Partner Dashboard:
Configuring Webhooks in Shopify Partner Dashboard:
Log in to your Shopify Partner Dashboard.
Go to Apps
in the Partner Dashboard.
Locate and click on the specific app that you want to update.
Inside the app, find and click on App setup.
In the GDPR mandatory webhooks section, update the endpoints for the three GDPR webhook types with the URLs you generated in step 2.
After updating the endpoints, click Save
to save your changes.
These steps ensure that your EcartAPI app is set up to receive GDPR webhooks from Shopify. Once configured, Shopify will send webhook events to the specified URLs, and your EcartAPI app can process the incoming data as needed.
Remember that you only need to set up these webhooks once, as duplicate setups can lead to duplicated requests. Make sure to handle the incoming webhook data in your EcartAPI app as per your requirements for GDPR compliance.
GET https://eshop-deve.herokuapp.com/api/v2/products
Use this resource to get the list of the seller's offers. You can use different query parameters to filter the list
GET https://api.ecartapi.com/api/v2/products/{{id}}
Obtain a single product information.
POST https://api.ecartapi.com/api/v2/products
Use this resource to propose a product
https://developer.allegro.pl/documentation#operation/proposeSaleProduct
PUT https://api.ecartapi.com/api/v2/products/{{id}}
Use this resource to propose changes in product.
GET htpps://api.ecartapi.com/api/v2/orders
Use this resource to get an order list.
GET htpps://api.ecartapi.com/api/v2/orders/{{id}}
Use this resource to get an order details.
GET htpps://api.ecartapi.com/api/v2/orders/{{orderId}}/fulfillments
Get a list of parcel tracking numbers currently assigned to the order.
POST https://api.ecartapi.com/api/v2/orders/{{id}}/fulfillments
Add a parcel tracking number (shipment) to given order line items.
GET https://api.ecartapi.com/api/v2/store
Use this resource when you need basic information about authenticated user.
GET https://api.ecartapi.com/api/v2/shippings
Retrieves all store shipping methods currently available on the platform, as well as those that have already been discontinued.
GET https://api.ecartapi.com/api/v2/services/carriers
Shipping carriers are essential to provide accurate tracking experience for customers. Use this resource to get a list of all available shipping carriers.
GET https://api.ecartapi.com/api/v2/customers
Use this resource to get details of many contacts.
GET https://api.ecartapi.com/api/v2/customers/{{id}}
Use this resource to get contact details.
POST https://api.ecartapi.com/api/v2/customers
Use this resource to create a new contact.
PUT https://api.ecartapi.com/api/v2/customers/{{id}}
Use this resource to modify contact details.
GET https://api.ecartapi.com/api/v2/products
This request allows the consultation of all amazons products by store.
There are no available filters in this request.
GET https://api.ecartapi.com/api/v2/products/{{id}}
Searches for a selected product and shows the detailed information.,
StartFragment,
Returns details about a listings item for a selling partner.
EndFrag
Important information:
The product's ID must exist Ex. B07ST32MMF
POST https://api.ecartapi.com/api/v1/products?sku=123456789
PUT https://api.ecartapi.com/api/v2/products/7500465062801
Available only for update inventory
GET https://api.ecartapi.com/api/v2/orders
Request to consult All Amazon orders.
Information about shipping address and customer might be incomplete.
By default this request will fetch only the merchant fulfillable orders (to comply with the use case of creating shipments) if you require all of the order information you must make the Get a single order request
Returns orders created or updated during the time frame indicated by the specified parameters. You can also apply a range of filtering criteria to narrow the list of orders returned. If age next token is present, that will be used to retrieve the orders instead of other criteria.
Amazon has different channels to define the type of orders MFN orders are the only ones available to do fulfillments via third party carriers the rest of the orders Amazon handles them internally
GET https://api.ecartapi.com/api/v2/orders/{{id}}
Searches for a selected order and shows the detailed information.
Important information:
The order's ID must exist
GET https://api.ecartapi.com/api/v2/webhooks?ecommerce=true
Use v1 o v2 API with the ecommerce param equals to true to get native webhooks.
GET https://api.ecartapi.com/api/v2/webhooks/{{id}}
Retrieves information of a single webhook from your store
POST https://api.ecartapi.com/api/v2/webhooks
Request to create new webhooks
PUT https://api.ecartapi.com/api/v2/webhooks/{{id}}
DELETE https://api.ecartapi.com/api/v2/webhooks/{{id}}
DELETE localhost:3000/api/v1/webhooks/{{subscriptionId}}?ecommerce=true
Just use it if get webhook resource doesn't find the webhook in our system but continues existing in Amazon when using the param e-commerce=true
GET https://api.ecartapi.com/api/v2/orders/{{orderId}}/fulfillments/{{id}}
Returns the shipment information for an existing shipment.
Important information:
The order's ID must exist
The fulfillment order's ID must exist
POST https://api.ecartapi.com/api/v2/orders/{{orderId}}/fulfillments
Create a shipment with the information provided.
Important information:
The order's ID must exist
Package object is REQUIRED.
More information about the ecommerce's resource.
When you are working with any of the below listed carriers it is recommended for you to send the company string value as listed below. This allows Amazon to automatically update the status of shipping labels generated.
It is not required for developers to send a value from this list if you do not send a value from this list then the carrier falls into the other category. In this case the status of shipping labels will not be updated automatically.
17FEIA, 360lion, 4PX, A-1, AAA Cooper, ABF, AFL/Fedex, ALLJOY, AMAUK, AMAZON HORIZON, Amazon Shipping, AMZL, AMZLUK, Andere, Anjun, AO, AO Deutschland, APC, APC Overnight, APC POSTAL LOGISTICS, APG eCommerce, Aramex, ARAS, Aras Kargo, Arco Spedizioni, Arkas, Arrow XL, Asendia, Asgard, Assett, AT POST, ATS, AUSSIEPOST, Australia Post, Australia Post-ArticleID, Australia Post-Consignment, B2C, B2C Europe, B2CShip, Balnak, Bartolini, Beijing Quanfeng Express, Best Buy, Best Express, Better Trucks, BJS, Blowhorn, Blue Package, BlueDart, Boğaziçi, Bombax, Bombino Express, BPOST, BR1 Express, BRT, Buylogic, Canada Post, Canpar, CargoLine, Caribou, Cart2India, CBL, CDC, CELERITAS, Centex, CEVA, Ceva Lojistik, China Post, Chrono Express, Chronopost, Chukou1, Cititrans, City Link, CityPost, CNE, Coliposte, Colis Privé, Colissimo, Consegna Mezzi Propri, Conway, Correios, Correos, Correos Express, COSCO, CouriersPlease, CTT EXPRESS, Cubyn, DACHSER, DAIPOST, DB Schenker, DEL Deliveries, Delhivery, Delivengo, Delivery Group, Der Kurier, Deutsche Post, DFL, DHL, DHL eCommerce, DHL Express, DHL Freight, DHL Global Mail, DHL Home Delivery, DHL Kargo, DHL-Paket, DHL Parcel UK, DHLPL, Digital Delivery, DirectLog, Dotzot, DPB, DPD, DPD Local, DSV, DTDC, DX, DX Express, DX Freight, DX Secure, DYNAMIC EXPRESS, ECMS, ECMS express, Ecom Express, Ecom Shipping solutions PVT ltd, EINSA SOURCING, EKI Trans, Emirates Post, Emons, Endopack, Energo, Envialia, ePost Global, Equick, Estafeta, Estes, EUB, Europaczka, Exapaq, FAST EST, Fastway, FedEx, Fedex Freight, FEDEX JP, FedEx SmartPost, FERCAM, Fillo Kargo, First Flight, First Flight China, First Mile, Fleetan, Flyt, FRACHTPOST, FRANCE EXPRESS, Gati, GEL, GEL Express, geodis, Geodis Calberson, Geopost Kargo, GFS, GLS, GO!, Gojavas, GRUPO LOGISTIC, Hellmann, Heppner, Hermes, Hermes (Corporate), Hermes Einrichtungsservice, Hermes Logistik Gruppe, Hermes UK, Hlog, HNC, Home Logistics, honesteye, Hongkong Post, Horoz Lojistik, Hotpoint Logistics, HRP, HS code, HUAHAN Logistics, HubEurope, Hunter Logistics, Huxloe, Huxloe Logistics, ICC Worldwide, IDS, IDS Netzwerk, iMile, India Post, InPost, Interlink, Interno, Intersoft, iParcel, ITD Global, J&T Express, Japan Post, JCEX, Jersey Post, Jiufang, JP EXPRESS, JPL UPU, JS Express, JT, Kargokar, KEAVO, Kerry, Kuehne+Nagel, Kybotech, La Poste, Landmark, Landmark Global, Lasership, Lemonmode, LF Logistic, Liccardi, Liccardi Trasporti, Logistik Gruppe, Loomis, Mail Alliance, Mail Americas, Mainpost, MBE, Metro Kargo, Mezzi propri, MHI, Milkman, MNG Kargo, Mondial Relay, MRW, MZZ-Briefdienst, Nacex, NAQEL EXPRESS, Narpost Kargo, New Zealand Post, Newgistics, Nexive, Ninjavan, NipponExpress, NITTSU, NOVEO, NowBikes, NTL, OCS Worldwide, Old Dominion, OneWorldExpress, ONTIME, OnTrac, OSM, OSM Worldwide, Overnite Express, Palletline, Palletways, Panther, Parcel Hub, Parcel Monkey, Parcel Station, Parcel2go, ParcelDenOnline, Parcelforce, Parcelhub, Parcelink Logistics, Parcelnet, ParcelOne, PDC Logistics, Pilot, Pilot Freight, PIN, Polish Post, Pos Laju, Post Modern, Poste Italiane, PostNL, PostNord, Professional, PTT Kargo, PUROLATOR, Qxpress, R+L, Raben Group, RBNA, REDUR, Rhenus, Rieck, Rivigo, RMLGB, Roadrunner, Royal Mail, RR Donnelley, Safexpress, SAGAWA, SAGAWA EXPRESS, Saia, Sailpost, Schweizer Post, SDA, Seino, SEINO TRANSPORTATION, Seko Logistics, Selem Kargo, Self Delivery, Sendcloud, Sending, SENDLE, Seur, Seven Senders, SF Express, SFC, Ship Delight, Ship Global US, SHIPA, ShipEconomy, ShipGlobal, Shipmate, Shippit, Shree Maruti Courier, Shree Tirupati Courier, Shunfeng Express, Singapore Post, Sinotrans, Skypostal, Smartmail, Smartrlogistics, SMSA, SMSA Express, Soarmall, Sonstige, South Eastern Freight Lines, Speedaf, Speedex, Spoton, SPRING, spring GDS, Sprint, Stahlmann and Sachs, Stampit, Staples, StarTrack-ArticleID, StarTrack-Consignment, STG, STO Express, Streamlite, Sunyou, Sürat Kargo, Susa, Swiss post, Szendex, Target, TDN, Tezel Lojistik, The Delivery Group, The Professional Couriers, TIPSA, TNT, TNT Kargo, TNTIT, Toll, Toll Global Express, Tongda Global, Topyou, Total Express, Tourline, Trackon, Trakpak, Transaher, Transaragonés, TransFolha, Translink, Trans-o-Flex, Truline, TSB, Tuffnells, TWS, TXT, TyD, UBI, UKMail, UPakWeShip, UPS, UPS Freight, UPS Mail Innovations, Upsilon, UPSMI, Urban Express, Uship, USPS, Verage Shipping, Via Xpress, VIR, VNLIN, WanbExpress, Watkins and Shepard, Wefast, WeWorldExpress, Whistl, Whizzard, WINIT, WPX, XDP, XPO, XPO Freight, Xpressbees, YAMATO, YAMATO TRANSPORT, YANWEN, YDH, Yellow Freight, YFHEX, Yodel, YTO Express, Yun Express, Yunda Express, Yurtiçi Kargo, Zeleris, ZTO Express, Zust Ambrosetti
POST https://api.ecartapi.com/api/v2/orders/{{orderId}}/fulfillments/{{id}}/cancel
Cancel the shipment indicated by the specified fulfillment identifer.
Important information:
The order's ID must exist
The fulfillment order's ID must exist
GET https://api.ecartapi.com/api/v1/catalog/search
GET https://api.ecartapi.com/api/v2/products
Returns a list of Products. Optional filter parameters can be passed in.
GET https://api.ecartapi.com/api/v2/products/{{id}}
Searches for a selected product and shows the detailed information.
Important information:
The product's ID must exist
POST https://api.ecartapi.com/api/v2/products
This request allows you to create a new product in a Bigcommerce store. Only one product can be created at the time.
BigCommerce has a set of rules to follow when creating products.
Required Fields to create a product:
* name
* productType
* dimensions.weight
* price
Limits on information sent on fields.
* name. Must be less than 250 charaters.
* productType. Allowed Values [ physical, digital ].
PUT https://api.ecartapi.com/api/v2/products/{{id}}
This request allows to update the information on a Bigcommerce product.
If you wish your product to have multiple categories asociated to it, send a string of the multiple categories Ids you wish your product to have separated by comas.
Limits on information sent on fields.
* name. Must be less than 250 charaters.
* productType. Allowed Values [ physical, digital ].
DELETE https://api.ecartapi.com/api/v2/products/{{id}}
GET https://api.ecartapi.com/api/v2/products/{{productId}}/images
The request will return all the images associated to the item.
GET https://api.ecartapi.com/api/v2/products/{{productId}}/images/{{id}}
Retrieves information on a single product image.
POST https://api.ecartapi.com/api/v2/products/{{productId}}/images
This request allows to add new images as thumbnails on products.
* image.url
has a 255 character limit.
* Supported image file types are BMP, GIF, JPEG, PNG, WBMP, XBM, and WEBP.
DELETE https://api.ecartapi.com/api/v2/products/{{productId}}/images/{{id}}
Deletes a Product Image.
GET https://api.ecartapi.com/api/v2/products/{{productId}}/variants
Returns a list of product Variants. Optional parameters can be passed in.
GET https://api.ecartapi.com/api/v2/products/{{productId}}/variants/{{id}}
Searches for a selected product variant and shows the detailed information.
Important information.
* Product identifier is required.
* Variant identifier is required.
POST https://api.ecartapi.com/api/v2/products/{{productId}}/variants
Creates a Product Variant.
Important information.
* Product identifier is required.
Required Fields
* sku
* option_values
Limits
* 600 SKUs per product limit.
* 255 characters SKU length limit.
Variants need to be created one at a time using this endpoint.
PUT https://api.ecartapi.com/api/v2/products/{{productId}}/variants/{{id}}
Updates a product Variant.
Important information.
* Product identifier is required.
* Variant identifier is required.
DELETE https://api.ecartapi.com/api/v2/products/{{productId}}/variants/{{id}}
GET https://api.ecartapi.com/api/v2/categories
Returns a list of categories.
GET https://api.ecartapi.com/api/v2/categories/{{id}}
Searches for a selected category and shows the detailed information.
Important information:
The category's identifier must exist.
POST https://api.ecartapi.com/api/v2/categories
Creates a Category.
Only works with categories of a default BigCommerce storefront.
Required Fields:
* parent_id
:
* To create a child category, set the parent_id
to the parent category.
* To create a top level category, set the parent_id
to 0
.
* name
Limits:
* 16,000 categories per store limit.
* 1,000 categories per product limit.
* 50 characters category name length.
* 8 levels of category depth limit.
* 65,642 characters category description length limit.
PUT https://api.ecartapi.com/api/v2/categories/{{id}}
Updates a Category.
Important information:
The category's identifier must exist
DELETE https://api.ecartapi.com/api/v2/categories/{{id}}
Deletes a Category.
GET https://api.ecartapi.com/api/v2/customers
Returns a list of Customers. Optional filter parameters can be passed in.
GET https://api.ecartapi.com/api/v2/customers/{{id}}
Returns a single Customer.
Important information:
The customer's identifiers must exist.
GET https://api.ecartapi.com/api/v2/customers/count
Returns a count of all Customers.
POST https://api.ecartapi.com/api/v2/customers
Creates a Customer. Required Fields
* first_name
* last_name
* email
PUT https://api.ecartapi.com/api/v2/customers/{{id}}
Updates a Customer.
Important information:
The customer's identifiers must exist.
DELETE https://api.ecartapi.com/api/v2/customers/{{id}}
Deletes a Customer.
Important information:
The customer's identifiers must exist.
GET https://api.ecartapi.com/api/v2/orders
Gets a list of orders using the filter query.
GET https://api.ecartapi.com/api/v2/orders/count
GET https://api.ecartapi.com/api/v2/orders/{{id}}
Returns the information of a single order.
Important information:
The order's ID must exist
POST https://api.ecartapi.com/api/v2/orders
Creates an Order.
An order can be created with an existing catalog product or a custom product.
Required Fields
* shippingAddress.
* items.
Request payload options.
Key | Values |
---|---|
Status | pending, in process, paid, cancelled, refunded |
PUT https://api.ecartapi.com/api/v2/orders/{{id}}
Updates an Order.
The body should only contain the fields that need to be updated.
The fields that are omitted will not be changed.
To remove a product from an order, set that product’s quantity to 0.
Important information:
The order's Identifier must exist.
Request payload options.
Key | Values |
---|---|
Status | pending, in process, paid, cancelled, refunded |
Order Status Descriptions
THE STATUSES LISTED IN THE TABLE DO NOT REPRESENT ECARTAPI STATUSES THIS IS A DETAILED LIST OF BIGCOMMERCE STATUSES FOR REFERENCE.
STATUS ID | NAME | DESCRIPTION |
---|---|---|
0 | Incomplete | An incomplete order happens when a shopper reached the payment page, but did not complete the transaction. |
1 | Pending | Customer started the checkout process, but did not complete it. |
2 | Shipped | Order has been shipped, but receipt has not been confirmed; seller has used the Ship Items action. |
3 | Partially Shipped | Only some items in the order have been shipped, due to some products being pre-order only or other reasons. |
4 | Refunded | Seller has used the Refund action. |
5 | Cancelled | Seller has cancelled an order, due to a stock inconsistency or other reasons. |
6 | Declined | Seller has marked the order as declined for lack of manual payment, or other reasons. |
7 | Awaiting Payment | Customer has completed checkout process, but payment has yet to be confirmed. |
8 | Awaiting Pickup | Order has been pulled, and is awaiting customer pickup from a seller-specified location. |
9 | Awaiting Shipment | Order has been pulled and packaged, and is awaiting collection from a shipping provider. |
10 | Completed | Client has paid for their digital product and their file(s) are available for download. |
11 | Awaiting Fulfillment | Customer has completed the checkout process and payment has been confirmed. |
12 | Manual Verification Required | Order is on hold while some aspect needs to be manually confirmed. |
13 | Disputed | Customer has initiated a dispute resolution process for the PayPal transaction that paid for the order. |
14 | Partially Refunded | Seller has partially refunded the order. |
DELETE https://api.ecartapi.com/api/v2/orders/{{id}}
Archives an order.
Important information:
The order's Identifier must exist.
POST https://api.ecartapi.com/api/v2/orders/{{id}}/complete
Update an order into the complete status.
Important information:
The order's identifier must exist
In case the store owner changed the value of this status you can use the ID for reference. On Bigcommerce this status is related to the ID 10.
POST https://api.ecartapi.com/api/v2/orders/{{id}}/cancel
Update an order into the cancelled status.
Important information:
The order's identifier must exist
In case the store owner changed the value of this status you can use the ID for reference. On Bigcommerce this status is related to the ID 5.
GET https://api.ecartapi.com/api/v2/orders/{{orderId}}/fulfillments
Gets a list of all shipments on an order.
GET https://api.ecartapi.com/api/v2/orders/{{orderId}}/fulfillments/{{id}}
Gets an order shipment.
Important information:
The order's identifier must exist
POST https://api.ecartapi.com/api/v2/orders/{{orderId}}/fulfillments
This request creates associates a shipping label with the order.
Important information:
The order's identifier must exist
You can send the items array when you wish to make a partial fulfillment. Otherwise do not send the items array and automatically the fulfillment will be applied to the full order.
shippingAddressId
- REQUIRED. The value can be obtained from the Get Single Order Request
PUT https://api.ecartapi.com/api/v2/orders/{{orderId}}/fulfillments/{{id}}
Updates an existing shipment associated with an order.
Important information:
The order's identifier must exist.
The fulfillment identifier must exist.
POST https://api.ecartapi.com/api/v2/orders/{{orderId}}/fulfillments/{{id}}/cancel
Deletes a shipment associated with an order.
Important information:
The order's identifier must exist
Fulfillment identifier must exist
GET https://api.ecartapi.com/api/v2/webhooks
With this request you will be able to consult all the webhooks associated to the store
GET https://api.ecartapi.com/api/v2/webhooks/{{id}}
Retrieves information of a single webhook from your store
POST https://api.ecartapi.com/api/v2/webhooks
Request to create new webhooks
PUT https://api.ecartapi.com/api/v2/webhooks/{{id}}
Important information:
The webhook's identifier must exist
DELETE https://api.ecartapi.com/api/v2/webhooks/{{id}}
Important information:
The webhook's identifier must exist
GET https://api.ecartapi.com/api/v2/store
Returns metadata about a store.
POST https://api.ecartapi.com/api/v2/services/carriers
Creates a shipping provider service for BigCommerce.
carrier.id must be exists
For get carrier.id field you need your Bigcommerce app ID to generate it, with your app ID and aditional information you must send a request by email to BigCommerce.
You can see more information about the request of carrier id here
PUT https://api.ecartapi.com/api/v2/services/carriers/643888944a60604b1069c99d
DELETE https://api.ecartapi.com/api/v2/services/carriers/643888944a60604b1069c99d
GET https://api.ecartapi.com/api/v2/services/carriers
GET https://api.ecartapi.com/api/v2/locations
GET https://api.ecartapi.com/api/v2/locations/1
GET https://api.ecartapi.com/api/v2/orders
GET https://api.ecartapi.com/api/v2/orders/{{id}}
POST https://api.ecartapi.com/api/v2/orders
PUT https://api.ecartapi.com/api/v2/orders/{{id}}
GET https://api.ecartapi.com/api/v2/products
POST https://api.ecartapi.com/api/v2/products
PUT https://api.ecartapi.com/api/v2/products/{{id}}
GET https://api.ecartapi.com/api/v2/orders/{{orderId}}/fulfillments
GET https://api.ecartapi.com/api/v2/orders/{{orderId}}/fulfillments/{{id}}
POST https://api.ecartapi.com/api/v2/orders/{{orderId}}/fulfillments
PUT https://api.ecartapi.com/api/v2/orders/{{orderId}}/fulfillments/{{id}}
GET https://api.ecartapi.com/api/v2/webhooks
POST https://api.ecartapi.com/api/v2/webhooks
DELETE https://api.ecartapi.com/api/v2/webhooks/:id
GET https://api.ecartapi.com/api/v2/products
GET https://api.ecartapi.com/api/v2/products/{{id}}
PUT {{hostname}}/api/v2/products/{{id}}
POST {{hostname}}/api/v2/products
GET https://api.ecartapi.com/api/v2/categories
GET https://api.ecartapi.com/api/v2/categories/21988
GET https://api.ecartapi.com/api/v2/orders?action=pendientes
POST https://api.ecartapi.com/api/v2/orders/{{orderId}}/fulfillments
GET https://api.ecartapi.com/api/v2/products
GET https://api.ecartapi.com/api/v2/products/16194
POST https://api.ecartapi.com/api/v2/products
Request that creates a product.
PUT https://api.ecartapi.com/api/v2/products/{{id}}
Request that updates product information.
DELETE https://api.ecartapi.com/api/v2/products/{{id}}
Request that permanently deletes the product.
GET https://api.ecartapi.com/api/v2/products/16194/variants
GET https://api.ecartapi.com/api/v2/products/{{productId}}}/variants
Fetch product variants information
GET https://api.ecartapi.com/api/v2/products/{{productId}}}/variants/{{id}}
Fetch product variant information
GET https://api.ecartapi.com/api/v2/categories
Fetch categories information.
GET https://api.ecartapi.com/api/v2/categories/{{id}}
Refer to a particular category.
POST https://api.ecartapi.com/api/v2/categories
Create a new category.
PUT https://api.ecartapi.com/api/v2/categories/{{id}}
Update category information.
GET https://api.ecartapi.com/api/v2/orders
Retrieve all orders information from the store.
GET https://api.ecartapi.com/api/v2/orders/{{id}}
Retrieve detailed order information.
POST https://api.ecartapi.com/api/v2/orders
Create a order and shows the detailed information.
To create a order the customer's ID is required.
You can get the customer Id from the customer requests.
To create a order the shippingMethod as ID is required.
You can get the shippingMethod ID from the shippings requests.
PUT https://api.ecartapi.com/api/v2/orders/{{id}}
Update order information.
GET https://api.ecartapi.com/api/v2/orders/{{orderId}}/fulfillments/{{id}}
Fetch order fulfillments information.
POST https://api.ecartapi.com/api/v2/orders/{{orderId}}/fulfillments
Create a order Fulfillment and shows the detailed information.
To create a new order Fulfillment these fields are required
* customerId
* shippingMethod
* shippingMethodId
You can get the customer Id from the customer requests.
You can get the shippingMethodID and shippingMethod from the shippings requests.
POST https://api.ecartapi.com/api/v2/orders/{{oderId}}/fulfillments/{{id}}/cancel
Cancel fulfillment.
GET https://api.ecartapi.com/api/v2/store/all
This request returns the list of stores with their details.
GET https://api.ecartapi.com/api/v2/store/{{id}}
Get the details of a specific store.
GET https://api.ecartapi.com/api/v2/shippings
Retrieves all store shipping methods.
GET https://api.ecartapi.com/api/v2/shippings/{{id}}
Filter shipping method for shippingId.
Get a shippingId with get all shippings API call
GET https://api.ecartapi.com/api/v2/customers
Refer to all users.
GET https://api.ecartapi.com/api/v2/customers/{{id}}
Fetch detailed information about a customer.
GET https://api.ecartapi.com/api/v2/products
This call retrieves all inventory item records defined for the seller's account.
GET https://api.ecartapi.com/api/v2/products/{{id}}
This call retrieves the inventory item record for a given Identifier.
Important information:
* The product's ID must exist
POST https://api.ecartapi.com/api/v2/products
To create a new product marketplaceId is required.
Find more information about marketplace Id here.
You can also get the marketplace Id from the product listings requests.
POST https://api.ecartapi.com/api/v1/products
PUT https://api.ecartapi.com/api/v2/products/{{id/sku}}
By sending this payload, you will be able to only update products inventory and price and their offers quantity and price in a single request.
The product ID is equal to the Product SKU.
* the offers array is optional.
* when sending the price object in offers currency and value are required.
DELETE https://api.ecartapi.com/api/v2/products/{{id}}
This call is used to delete an inventory item record associated with a specified SKU/Identifier.
A successful call will not only delete that inventory item record, but will also have the following effects:
* Delete any and all unpublished offers associated with that SKU;
* Delete any and all single-variation eBay listings associated with that SKU;
* Automatically remove that SKU from a multiple-variation listing and remove that SKU from any and all inventory item groups in which that SKU was a member.
GET https://api.ecartapi.com/api/v1/policies/sellerPrograms
POST https://api.ecartapi.com/api/v1/policies/sellerPrograms
POST https://api.ecartapi.com/api/v1/policies/fulfillments
POST https://api.ecartapi.com/api/v1/policies/payments
POST https://api.ecartapi.com/api/v1/policies/returns
GET https://api.ecartapi.com/api/v1/policies/fulfillments/{{id}}
This request provides all the information regarding the policies available by every Ebay marketplace.
The values you can send as values in {{ marketplace }} are the following.
* EBAY_AT
Indicates the eBay marketplace for Austria (https://www.ebay.at).
* EBAY_AU
Indicates the eBay marketplace for Australia (https://www.ebay.com.au).
* EBAY_BE
Indicates the eBay marketplace for Belgium (https://www.ebay.be/).
* EBAY_CA
Indicates the eBay marketplace for Canada (https://www.ebay.ca).
* EBAY_CH
Indicates the eBay marketplace for Switzerland (https://www.ebay.ch).
* EBAY_CN
Reserved for future use.
* EBAY_CZ
Reserved for future use.
* EBAY_DE
Indicates the eBay marketplace for Germany (https://www.ebay.de).
* EBAY_DK
Reserved for future use.
* EBAY_ES
Indicates the eBay marketplace for Spain (https://www.ebay.es).
* EBAY_FI
Reserved for future use.
* EBAY_FR
Indicates the eBay marketplace for France (https://www.ebay.fr).
* EBAY_GB
Indicates the eBay marketplace for Great Britain (https://www.ebay.co.uk).
* EBAY_GR
Reserved for future use.
* EBAY_HK
Indicates the eBay marketplace for Hong Kong (https://www.ebay.com.hk).
* EBAY_HU
Reserved for future use.
* EBAY_ID
Reserved for future use.
* EBAY_IE
Indicates the eBay marketplace for Ireland (https://www.ebay.ie).
* EBAY_IL
Reserved for future use.
* EBAY_IN
Indicates the eBay marketplace for India (https://www.ebay.in).
* EBAY_IT
Indicates the eBay marketplace for Italy (https://www.ebay.it).
* EBAY_JP
Reserved for future use.
* EBAY_MY
Indicates the eBay marketplace for Malaysia (https://www.ebay.com.my).
* EBAY_NL
Indicates the eBay marketplace for the Netherlands (https://www.ebay.nl).
* EBAY_NO
Reserved for future use.
* EBAY_NZ
Reserved for future use.
* EBAY_PE
Reserved for future use.
* EBAY_PH
Indicates the eBay marketplace for the Philippines (https://www.ebay.ph).
* EBAY_PL
Indicates the eBay marketplace for Poland (https://www.ebay.pl).
* EBAY_PR
Reserved for future use.
* EBAY_PT
Reserved for future use.
* EBAY_RU
Reserved for future use.
* EBAY_SE
Reserved for future use.
* EBAY_SG
Indicates the eBay marketplace for Singapore (https://www.ebay.com.sg).
* EBAY_TH
Indicates the eBay marketplace for Thailand (https://info.ebay.co.th).
* EBAY_TW
Indicates the eBay marketplace for Taiwan (https://www.ebay.com.tw).
* EBAY_US
Indicates the eBay marketplace for the United States (https://www.ebay.com).
* EBAY_VN
Indicates the eBay marketplace for Vietnam (https://www.ebay.vn).
* EBAY_ZA
Reserved for future use.
* EBAY_HALF_US
No longer used.
* EBAY_MOTORS_US
Indicates the parent category for Auto Parts and Vehicles
on the EBAY_US marketplace (https://www.ebay.com/motors).
You can find more information about this marketplace value in ebays documentation here.
GET https://api.ecartapi.com/api/v1/policies/payments/{{id}}
This request provides all the information regarding the policies available by every Ebay marketplace.
The values you can send as values in {{ marketplace }} are the following.
* EBAY_AT
Indicates the eBay marketplace for Austria (https://www.ebay.at).
* EBAY_AU
Indicates the eBay marketplace for Australia (https://www.ebay.com.au).
* EBAY_BE
Indicates the eBay marketplace for Belgium (https://www.ebay.be/).
* EBAY_CA
Indicates the eBay marketplace for Canada (https://www.ebay.ca).
* EBAY_CH
Indicates the eBay marketplace for Switzerland (https://www.ebay.ch).
* EBAY_CN
Reserved for future use.
* EBAY_CZ
Reserved for future use.
* EBAY_DE
Indicates the eBay marketplace for Germany (https://www.ebay.de).
* EBAY_DK
Reserved for future use.
* EBAY_ES
Indicates the eBay marketplace for Spain (https://www.ebay.es).
* EBAY_FI
Reserved for future use.
* EBAY_FR
Indicates the eBay marketplace for France (https://www.ebay.fr).
* EBAY_GB
Indicates the eBay marketplace for Great Britain (https://www.ebay.co.uk).
* EBAY_GR
Reserved for future use.
* EBAY_HK
Indicates the eBay marketplace for Hong Kong (https://www.ebay.com.hk).
* EBAY_HU
Reserved for future use.
* EBAY_ID
Reserved for future use.
* EBAY_IE
Indicates the eBay marketplace for Ireland (https://www.ebay.ie).
* EBAY_IL
Reserved for future use.
* EBAY_IN
Indicates the eBay marketplace for India (https://www.ebay.in).
* EBAY_IT
Indicates the eBay marketplace for Italy (https://www.ebay.it).
* EBAY_JP
Reserved for future use.
* EBAY_MY
Indicates the eBay marketplace for Malaysia (https://www.ebay.com.my).
* EBAY_NL
Indicates the eBay marketplace for the Netherlands (https://www.ebay.nl).
* EBAY_NO
Reserved for future use.
* EBAY_NZ
Reserved for future use.
* EBAY_PE
Reserved for future use.
* EBAY_PH
Indicates the eBay marketplace for the Philippines (https://www.ebay.ph).
* EBAY_PL
Indicates the eBay marketplace for Poland (https://www.ebay.pl).
* EBAY_PR
Reserved for future use.
* EBAY_PT
Reserved for future use.
* EBAY_RU
Reserved for future use.
* EBAY_SE
Reserved for future use.
* EBAY_SG
Indicates the eBay marketplace for Singapore (https://www.ebay.com.sg).
* EBAY_TH
Indicates the eBay marketplace for Thailand (https://info.ebay.co.th).
* EBAY_TW
Indicates the eBay marketplace for Taiwan (https://www.ebay.com.tw).
* EBAY_US
Indicates the eBay marketplace for the United States (https://www.ebay.com).
* EBAY_VN
Indicates the eBay marketplace for Vietnam (https://www.ebay.vn).
* EBAY_ZA
Reserved for future use.
* EBAY_HALF_US
No longer used.
* EBAY_MOTORS_US
Indicates the parent category for Auto Parts and Vehicles
on the EBAY_US marketplace (https://www.ebay.com/motors).
You can find more information about this marketplace value in ebays documentation here.
GET https://api.ecartapi.com/api/v1/policies/returns/{{id}}
This request provides all the information regarding the policies available by every Ebay marketplace.
The values you can send as values in {{ marketplace }} are the following.
* EBAY_AT
Indicates the eBay marketplace for Austria (https://www.ebay.at).
* EBAY_AU
Indicates the eBay marketplace for Australia (https://www.ebay.com.au).
* EBAY_BE
Indicates the eBay marketplace for Belgium (https://www.ebay.be/).
* EBAY_CA
Indicates the eBay marketplace for Canada (https://www.ebay.ca).
* EBAY_CH
Indicates the eBay marketplace for Switzerland (https://www.ebay.ch).
* EBAY_CN
Reserved for future use.
* EBAY_CZ
Reserved for future use.
* EBAY_DE
Indicates the eBay marketplace for Germany (https://www.ebay.de).
* EBAY_DK
Reserved for future use.
* EBAY_ES
Indicates the eBay marketplace for Spain (https://www.ebay.es).
* EBAY_FI
Reserved for future use.
* EBAY_FR
Indicates the eBay marketplace for France (https://www.ebay.fr).
* EBAY_GB
Indicates the eBay marketplace for Great Britain (https://www.ebay.co.uk).
* EBAY_GR
Reserved for future use.
* EBAY_HK
Indicates the eBay marketplace for Hong Kong (https://www.ebay.com.hk).
* EBAY_HU
Reserved for future use.
* EBAY_ID
Reserved for future use.
* EBAY_IE
Indicates the eBay marketplace for Ireland (https://www.ebay.ie).
* EBAY_IL
Reserved for future use.
* EBAY_IN
Indicates the eBay marketplace for India (https://www.ebay.in).
* EBAY_IT
Indicates the eBay marketplace for Italy (https://www.ebay.it).
* EBAY_JP
Reserved for future use.
* EBAY_MY
Indicates the eBay marketplace for Malaysia (https://www.ebay.com.my).
* EBAY_NL
Indicates the eBay marketplace for the Netherlands (https://www.ebay.nl).
* EBAY_NO
Reserved for future use.
* EBAY_NZ
Reserved for future use.
* EBAY_PE
Reserved for future use.
* EBAY_PH
Indicates the eBay marketplace for the Philippines (https://www.ebay.ph).
* EBAY_PL
Indicates the eBay marketplace for Poland (https://www.ebay.pl).
* EBAY_PR
Reserved for future use.
* EBAY_PT
Reserved for future use.
* EBAY_RU
Reserved for future use.
* EBAY_SE
Reserved for future use.
* EBAY_SG
Indicates the eBay marketplace for Singapore (https://www.ebay.com.sg).
* EBAY_TH
Indicates the eBay marketplace for Thailand (https://info.ebay.co.th).
* EBAY_TW
Indicates the eBay marketplace for Taiwan (https://www.ebay.com.tw).
* EBAY_US
Indicates the eBay marketplace for the United States (https://www.ebay.com).
* EBAY_VN
Indicates the eBay marketplace for Vietnam (https://www.ebay.vn).
* EBAY_ZA
Reserved for future use.
* EBAY_HALF_US
No longer used.
* EBAY_MOTORS_US
Indicates the parent category for Auto Parts and Vehicles
on the EBAY_US marketplace (https://www.ebay.com/motors).
You can find more information about this marketplace value in ebays documentation here.
GET https://api.ecartapi.com/api/v1/policies/fulfillments/{marketplace}
This request provides all the information regarding the policies available by every Ebay marketplace.
The values you can send as values in {{ marketplace }} are the following.
* EBAY_AT
Indicates the eBay marketplace for Austria (https://www.ebay.at).
* EBAY_AU
Indicates the eBay marketplace for Australia (https://www.ebay.com.au).
* EBAY_BE
Indicates the eBay marketplace for Belgium (https://www.ebay.be/).
* EBAY_CA
Indicates the eBay marketplace for Canada (https://www.ebay.ca).
* EBAY_CH
Indicates the eBay marketplace for Switzerland (https://www.ebay.ch).
* EBAY_CN
Reserved for future use.
* EBAY_CZ
Reserved for future use.
* EBAY_DE
Indicates the eBay marketplace for Germany (https://www.ebay.de).
* EBAY_DK
Reserved for future use.
* EBAY_ES
Indicates the eBay marketplace for Spain (https://www.ebay.es).
* EBAY_FI
Reserved for future use.
* EBAY_FR
Indicates the eBay marketplace for France (https://www.ebay.fr).
* EBAY_GB
Indicates the eBay marketplace for Great Britain (https://www.ebay.co.uk).
* EBAY_GR
Reserved for future use.
* EBAY_HK
Indicates the eBay marketplace for Hong Kong (https://www.ebay.com.hk).
* EBAY_HU
Reserved for future use.
* EBAY_ID
Reserved for future use.
* EBAY_IE
Indicates the eBay marketplace for Ireland (https://www.ebay.ie).
* EBAY_IL
Reserved for future use.
* EBAY_IN
Indicates the eBay marketplace for India (https://www.ebay.in).
* EBAY_IT
Indicates the eBay marketplace for Italy (https://www.ebay.it).
* EBAY_JP
Reserved for future use.
* EBAY_MY
Indicates the eBay marketplace for Malaysia (https://www.ebay.com.my).
* EBAY_NL
Indicates the eBay marketplace for the Netherlands (https://www.ebay.nl).
* EBAY_NO
Reserved for future use.
* EBAY_NZ
Reserved for future use.
* EBAY_PE
Reserved for future use.
* EBAY_PH
Indicates the eBay marketplace for the Philippines (https://www.ebay.ph).
* EBAY_PL
Indicates the eBay marketplace for Poland (https://www.ebay.pl).
* EBAY_PR
Reserved for future use.
* EBAY_PT
Reserved for future use.
* EBAY_RU
Reserved for future use.
* EBAY_SE
Reserved for future use.
* EBAY_SG
Indicates the eBay marketplace for Singapore (https://www.ebay.com.sg).
* EBAY_TH
Indicates the eBay marketplace for Thailand (https://info.ebay.co.th).
* EBAY_TW
Indicates the eBay marketplace for Taiwan (https://www.ebay.com.tw).
* EBAY_US
Indicates the eBay marketplace for the United States (https://www.ebay.com).
* EBAY_VN
Indicates the eBay marketplace for Vietnam (https://www.ebay.vn).
* EBAY_ZA
Reserved for future use.
* EBAY_HALF_US
No longer used.
* EBAY_MOTORS_US
Indicates the parent category for Auto Parts and Vehicles
on the EBAY_US marketplace (https://www.ebay.com/motors).
You can find more information about this marketplace value in ebays documentation here.
GET https://api.ecartapi.com/api/v1/policies/payments/{{marketplace}}
This request provides all the information regarding the policies available by every Ebay marketplace.
The values you can send as values in {{ marketplace }} are the following.
* EBAY_AT
Indicates the eBay marketplace for Austria (https://www.ebay.at).
* EBAY_AU
Indicates the eBay marketplace for Australia (https://www.ebay.com.au).
* EBAY_BE
Indicates the eBay marketplace for Belgium (https://www.ebay.be/).
* EBAY_CA
Indicates the eBay marketplace for Canada (https://www.ebay.ca).
* EBAY_CH
Indicates the eBay marketplace for Switzerland (https://www.ebay.ch).
* EBAY_CN
Reserved for future use.
* EBAY_CZ
Reserved for future use.
* EBAY_DE
Indicates the eBay marketplace for Germany (https://www.ebay.de).
* EBAY_DK
Reserved for future use.
* EBAY_ES
Indicates the eBay marketplace for Spain (https://www.ebay.es).
* EBAY_FI
Reserved for future use.
* EBAY_FR
Indicates the eBay marketplace for France (https://www.ebay.fr).
* EBAY_GB
Indicates the eBay marketplace for Great Britain (https://www.ebay.co.uk).
* EBAY_GR
Reserved for future use.
* EBAY_HK
Indicates the eBay marketplace for Hong Kong (https://www.ebay.com.hk).
* EBAY_HU
Reserved for future use.
* EBAY_ID
Reserved for future use.
* EBAY_IE
Indicates the eBay marketplace for Ireland (https://www.ebay.ie).
* EBAY_IL
Reserved for future use.
* EBAY_IN
Indicates the eBay marketplace for India (https://www.ebay.in).
* EBAY_IT
Indicates the eBay marketplace for Italy (https://www.ebay.it).
* EBAY_JP
Reserved for future use.
* EBAY_MY
Indicates the eBay marketplace for Malaysia (https://www.ebay.com.my).
* EBAY_NL
Indicates the eBay marketplace for the Netherlands (https://www.ebay.nl).
* EBAY_NO
Reserved for future use.
* EBAY_NZ
Reserved for future use.
* EBAY_PE
Reserved for future use.
* EBAY_PH
Indicates the eBay marketplace for the Philippines (https://www.ebay.ph).
* EBAY_PL
Indicates the eBay marketplace for Poland (https://www.ebay.pl).
* EBAY_PR
Reserved for future use.
* EBAY_PT
Reserved for future use.
* EBAY_RU
Reserved for future use.
* EBAY_SE
Reserved for future use.
* EBAY_SG
Indicates the eBay marketplace for Singapore (https://www.ebay.com.sg).
* EBAY_TH
Indicates the eBay marketplace for Thailand (https://info.ebay.co.th).
* EBAY_TW
Indicates the eBay marketplace for Taiwan (https://www.ebay.com.tw).
* EBAY_US
Indicates the eBay marketplace for the United States (https://www.ebay.com).
* EBAY_VN
Indicates the eBay marketplace for Vietnam (https://www.ebay.vn).
* EBAY_ZA
Reserved for future use.
* EBAY_HALF_US
No longer used.
* EBAY_MOTORS_US
Indicates the parent category for Auto Parts and Vehicles
on the EBAY_US marketplace (https://www.ebay.com/motors).
You can find more information about this marketplace value in ebays documentation here.
GET https://api.ecartapi.com/api/v1/policies/returns/{{marketplace}}
This request provides all the information regarding the policies available by every Ebay marketplace.
The values you can send as values in {{ marketplace }} are the following.
* EBAY_AT
Indicates the eBay marketplace for Austria (https://www.ebay.at).
* EBAY_AU
Indicates the eBay marketplace for Australia (https://www.ebay.com.au).
* EBAY_BE
Indicates the eBay marketplace for Belgium (https://www.ebay.be/).
* EBAY_CA
Indicates the eBay marketplace for Canada (https://www.ebay.ca).
* EBAY_CH
Indicates the eBay marketplace for Switzerland (https://www.ebay.ch).
* EBAY_CN
Reserved for future use.
* EBAY_CZ
Reserved for future use.
* EBAY_DE
Indicates the eBay marketplace for Germany (https://www.ebay.de).
* EBAY_DK
Reserved for future use.
* EBAY_ES
Indicates the eBay marketplace for Spain (https://www.ebay.es).
* EBAY_FI
Reserved for future use.
* EBAY_FR
Indicates the eBay marketplace for France (https://www.ebay.fr).
* EBAY_GB
Indicates the eBay marketplace for Great Britain (https://www.ebay.co.uk).
* EBAY_GR
Reserved for future use.
* EBAY_HK
Indicates the eBay marketplace for Hong Kong (https://www.ebay.com.hk).
* EBAY_HU
Reserved for future use.
* EBAY_ID
Reserved for future use.
* EBAY_IE
Indicates the eBay marketplace for Ireland (https://www.ebay.ie).
* EBAY_IL
Reserved for future use.
* EBAY_IN
Indicates the eBay marketplace for India (https://www.ebay.in).
* EBAY_IT
Indicates the eBay marketplace for Italy (https://www.ebay.it).
* EBAY_JP
Reserved for future use.
* EBAY_MY
Indicates the eBay marketplace for Malaysia (https://www.ebay.com.my).
* EBAY_NL
Indicates the eBay marketplace for the Netherlands (https://www.ebay.nl).
* EBAY_NO
Reserved for future use.
* EBAY_NZ
Reserved for future use.
* EBAY_PE
Reserved for future use.
* EBAY_PH
Indicates the eBay marketplace for the Philippines (https://www.ebay.ph).
* EBAY_PL
Indicates the eBay marketplace for Poland (https://www.ebay.pl).
* EBAY_PR
Reserved for future use.
* EBAY_PT
Reserved for future use.
* EBAY_RU
Reserved for future use.
* EBAY_SE
Reserved for future use.
* EBAY_SG
Indicates the eBay marketplace for Singapore (https://www.ebay.com.sg).
* EBAY_TH
Indicates the eBay marketplace for Thailand (https://info.ebay.co.th).
* EBAY_TW
Indicates the eBay marketplace for Taiwan (https://www.ebay.com.tw).
* EBAY_US
Indicates the eBay marketplace for the United States (https://www.ebay.com).
* EBAY_VN
Indicates the eBay marketplace for Vietnam (https://www.ebay.vn).
* EBAY_ZA
Reserved for future use.
* EBAY_HALF_US
No longer used.
* EBAY_MOTORS_US
Indicates the parent category for Auto Parts and Vehicles
on the EBAY_US marketplace (https://www.ebay.com/motors).
You can find more information about this marketplace value in ebays documentation here.
GET https://api.ecartapi.com/api/v2/locations
GET https://api.ecartapi.com/api/v2/locations/{{id}}
POST https://api.ecartapi.com/api/v2/locations
DELETE https://api.ecartapi.com/api/v2/locations/{{id}}
GET https://api.ecartapi.com/api/v2/products/listings
This request will bring you all the products you have listed in Ebays platform.
* No more than 300 requests can be executed within any 15-second interval.
* It is required to send dates to fetch the information. By default we fetch product listings from a range of 30 days before til the current day
* Time ranges must be a value less than 120 days
GET https://api.ecartapi.com/api/v2/products/listings/{{id}}
This request will bring you not only the information of the product listing but the offer you have published in Ebay, this offers will allow you to update your published item information like quantity, description, quantity allowed per buyer, policies, etc.
You can Find more information about the Offer Update in our request Update Offer.
POST https://api.ecartapi.com/api/v1/products/listings
To create a new offer marketplaceId is required.
Find more information about marketplace Id here.
You can also get the marketplace Id from the product listings GET requests.
PUT https://api.ecartapi.com/api/v1/products/listings/{{id}}
For this request to be function properly the payload must include
"inventory": true
This request allows you to only update the products inventory and price please follow the payload as stated
POST https://api.ecartapi.com/api/v2/products/listings/publish/{{listingId}}
This call is used to convert an unpublished offer into a published offer, or live eBay listing. The unique identifier of the offer (offerId) is passed
POST https://api.ecartapi.com/api/v2/products/listings/migrate
With this call you will be able to control all the product listings created from the UI with the Ebay API.
REQUIREMENTS THE PRODUCTS LISTINGS MUST COMPLY.
To be eligible for migration, the active eBay listings must meet the following requirements:
GET https://api.ecartapi.com/api/v2/categories/{{id}}
Searches for the selected category and shows detailed information.
Important information:
The categories ID must exist
GET https://api.ecartapi.com/api/v2/orders
Use this resource to search for and retrieve one or more orders based on the last update date, creation date, or fulfillment status. You can alternatively list orders using the orderIds parameter. (max 50 ids)
ONLY PAID ORDERS WILL APPEAR ON THIS REQUEST
The returned Order objects contain information you can use to create and process fulfillments, including:
* Information about the buyer and seller
* Information about the order's line items
* The plans for packaging, addressing and shipping the order
* The status of payment, packaging, addressing, and shipping the order
* A summary of monetary amounts specific to the order such as pricing, payments, and shipping costs
* A summary of applied taxes and fees, and optionally a breakdown of each
GET https://api.ecartapi.com/api/v2/orders/{{id}}
Searches for a selected order and shows the detailed information.
Important information:
* The order's ID must exist
The returned Order object contains information you can use to create and process fulfillments, including:
* Information about the buyer and seller
* Information about the order's line items
* The plans for packaging, addressing and shipping the order
* The status of payment, packaging, addressing, and shipping the order
* A summary of monetary amounts specific to the order such as pricing, payments, and shipping costs
* A summary of applied taxes and fees, and optionally a breakdown of each
GET https://api.ecartapi.com/api/v2/orders/{{orderId}}/fulfillments
GET https://api.ecartapi.com/api/v2/orders/{{orderId}}/fulfillments/{{id}}
POST https://api.ecartapi.com/api/v2/orders/{{id}}/fulfillments
POST https://api.ecartapi.com/api/v2/refreshtoken
GET https://api.ecartapi.com/api/v2/products
GET https://api.ecartapi.com/api/v2/products/371595825
POST https://api.ecartapi.com/api/v2/products
PUT https://api.ecartapi.com/api/v2/products/{{id}}
DELETE https://api.ecartapi.com/api/v2/products/{{id}}
GET https://api.ecartapi.com/api/v2/products/{{productId}}/variants
GET https://api.ecartapi.com/api/v2/products/{{productId}}/variants/{{id}}
POST https://api.ecartapi.com/api/v2/products/{{productId}}/variants
PUT https://api.ecartapi.com/api/v2/products/{{productId}}/variants/{{id}}
GET https://api.ecartapi.com/api/v2/orders
GET https://api.ecartapi.com/api/v2/orders/{{id}}
POST https://api.ecartapi.com/api/v2/orders
PUT https://api.ecartapi.com/api/v2/orders/{{id}}
DELETE https://api.ecartapi.com/api/v2/orders/{{id}}
POST https://api.ecartapi.com/api/v2/categories
PUT https://api.ecartapi.com/api/v2/categories/{{id}}
GET https://api.ecartapi.com/api/v2/categories
GET https://api.ecartapi.com/api/v2/categories/{{id}}
DELETE https://api.ecartapi.com/api/v2/categories/{{id}}
POST https://api.ecartapi.com/api/v2/customers/
PUT https://api.ecartapi.com/api/v2/customers/{{id}}
GET https://api.ecartapi.com/api/v2/customers
GET https://api.ecartapi.com/api/v2/customers/{{id}}
DELETE https://api.ecartapi.com/api/v2/customers/{{id}}
GET https://api.ecartapi.com/api/v2/orders/{{orderId}}/fulfillments
POST https://api.ecartapi.com/api/v2/orders/{{orderId}}/fulfillments
PUT https://api.ecartapi.com/api/v2/orders/{{orderId}}/fulfillments/{{orderId}}
POST https://api.ecartapi.com/api/v2/orders/{{orderId}}/fulfillments/{{orderId}}/cancel
GET https://api.ecartapi.com/api/v2/carts
GET https://api.ecartapi.com/api/v2/carts/{{id}}
PUT https://api.ecartapi.com/api/v2/carts/{{id}}
GET https://api.ecartapi.com/api/v2/store/
GET {{hostname}}/api/v2/products
GET https://api.ecartapi.com/api/v2/products
Filter | Description |
page |
Pagination number. |
limit |
Limit size of the search |
'status[active]' |
Filter items by status of product: 'true' or 'false' |
name |
Filter items by attribute name |
GET https://api.ecartapi.com/api/v2/products/{{id}}
Searches for a selected product and shows the detailed information.
Important information:
GET https://api.ecartapi.com/api/v2/products/count
POST https://api.ecartapi.com/api/v2/products
PUT https://api.ecartapi.com/api/v2/products/{{id}}
Updates the product information, according to new detailed information.
Important information:
DELETE https://api.ecartapi.com/api/v2/products/{{id}}
Permanently delete the selected product.
Important information:
GET https://api.ecartapi.com/api/v2/products/{{productId}}/variants
Searches for all the registered variants of a single product.
Important information:
POST https://api.ecartapi.com/api/v2/products/{{productId}}/variants
Creates a variation of an available product.
Important information:
PUT https://api.ecartapi.com/api/v2/products/{{productId}}/variants/{{id}}
Updates the information of an already existing product variant
Important information:
DELETE https://api.ecartapi.com/api/v2/products/{{productId}}/variants/{{id}}
Permanently deletes a product's variation.
Important information:
GET https://api.ecartapi.com/api/v2/categories
GET https://api.ecartapi.com/api/v2/categories/{{id}}
Searches for the selected category and shows detailed information.
Important information:
GET https://api.ecartapi.com/api/v2/orders
Filter | Description |
limit |
Limit size of the search |
page |
Pagination number. |
search |
Filter orders by a text chain |
'status[status]' |
Filter orders by financial status |
GET https://api.ecartapi.com/api/v2/orders/count
GET https://api.ecartapi.com/api/v2/orders/{{id}}
Searches for a selected order and shows the detailed information.
Important information:
POST localhost:3000/api/v2/orders
POST https://api.ecartapi.com/api/v2/orders/{{id}}/cancel
Changes an order's fulfillment status to cancelled.
Important information:
GET localhost:3000/api/v2/orders/{{orderId}}/fulfillments
Shows all of the order's fulfillments detailed.
Important information:
GET localhost:3000/api/v2/orders/{{orderId}}/fulfillments/{{id}}
Shows a selected order fulfillment with detail.
Important information:
POST localhost:3000/api/v2/orders/{{orderId}}/fulfillments
Creates an order's fulfillment.
Important information:
PUT localhost:3000/api/v2/orders/{{orderId}}/fulfillments/{{id}}
Update the fulfillment information.
Important information:
GET https://api.ecartapi.com/api/v2/store/all
GET https://api.ecartapi.com/api/v2/store/{{id}}
GET https://api.ecartapi.com/api/v2/products
Endpoint to list Listings that belong to a Shop.
GET https://api.ecartapi.com/api/v2/products/{{productId}}
Retrieves a listing record by listing ID.
POST https://api.ecartapi.com/api/v2/products/:id?validate=true
To create a product in an Etsy shop, you need to provide specific information:
If the taxonomyId is not sent 19 is sent as default value.
whoMadefield: Specify the creator as
true
if you made the product. or false
if someone else did
made_to_order
, 2020_2022
, 2010_2019
, 2003_2009
, before_2003
, 2000_2002
, 1990s
, 1980s
, 1970s
, 1960s
, 1950s
, 1940s
, 1930s
, 1920s
, 1910s
, 1900s
, 1800s
, 1700s
or before_1700
physical
(tangible item), download
(digital file), or both
(available in both formats).
PUT https://api.ecartapi.com/api/v2/products/{{productId}}
Updates an ACTIVE Etsy product
For whoMade field you can use the values:
StartFragment
i_did
, someone_else
or collective
For whenMade field you can use the values:
made_to_order
, 2020_2022
, 2010_2019
, 2003_2009
, before_2003
, 2000_2002
, 1990s
, 1980s
, 1970s
, 1960s
, 1950s
, 1940s
, 1930s
, 1920s
, 1910s
, 1900s
, 1800s
, 1700s
or before_1700
DELETE https://api.ecartapi.com/api/v2/products/{{id}}
Delete an Etsy Product from a store.
WARNING:
A Product can be deleted only if the state is one of the following: SOLDOUT, DRAFT, EXPIRED, INACTIVE, ACTIVE and isavailable or ACTIVE and has seller flags: SUPRESSED (frozen), VACATION, CUSTOMSHOPS (pattern), SELLON_FACEBOOK
GET https://api.ecartapi.com/api/v2/products/{{productId}}/variants
Retrieves the inventory record for a listing. Listings you did not edit using the Etsy.com inventory tools have no inventory records. This endpoint returns SKU data if you are the owner of the inventory records being fetched.
GET https://api.ecartapi.com/api/v2/products/{{productId}}/variants/{{id}}
Retrieves the inventory record for a listing. Listings you did not edit using the Etsy.com inventory tools have no inventory records. This endpoint returns SKU data if you are the owner of the inventory records being fetched.
PUT https://api.ecartapi.com/api/v2/products/{{productId}}/variants/{{id}}
Updates the inventory for a listing identified by a listing ID. The update fails if the supplied values for product sku, offering quantity, and/or price are incompatible
When setting a price, assign a float equal to amount divided by divisor as specified in the Money resource.
POST https://api.ecartapi.com/api/v2/products/{{productId}}/images
To upload an image, you need to provide it in base64 format. It's also crucial to make the request without including Content-Type in the headers, as otherwise, the image will not be uploaded.
Images will always be published in JPG format.
The position property within the payload refers to the hierarchy the image will have within Etsy, with 1 being the default if it is not provided in the payload.
GET https://api.ecartapi.com/api/v2/products/{{productId}}/images
GET https://api.ecartapi.com/api/v2/products/{{productId}}/images/{{id}}
DELETE https://api.ecartapi.com/api/v2/products/{{productId}}/images/{{id}}
GET https://api.ecartapi.com/api/v2/orders
GET https://api.ecartapi.com/api/v2/orders/{{id}}
PUT https://api.ecartapi.com/api/v2/orders/2098218716
Updates a order.
Values for status.status: pending
, in proccess
, paid
, cancelled
, redunded
.
Values for fulfillmentStatus: false
or true
.
GET https://api.ecartapi.com/api/v2/orders/{{orderId}}/fulfillments
POST https://api.ecartapi.com/api/v2/orders/{{orderId}}/fulfillments
Use this request to update the fulfillment status from your orders to fulfilled.
GET https://api.ecartapi.com/api/v2/store/feedback
To retrieve the reviews from your Etsy store
GET https://api.ecartapi.com/api/v2/store
Retrieves the Etsy shop related to the EcartAPI access token
GET https://api.ecartapi.com/api/v2/orders/carriers?countryCode2=string <ISO 3166-1 alpha-2>
GET https://api.ecartapi.com/api/v2/shippings
GET https://api.ecartapi.com/api/v2/shippings/{{id}}
GET https://api.ecartapi.com/api/v2/payments?ids={{id,id}}
GET https://api.ecartapi.com/api/v2/products
GET localhost:3000/api/v2/products/{{id}}
Searches for a selected product and shows the detailed information.
Important information:
GET https://api.ecartapi.com/api/v2/products/count
POST https://api.ecartapi.com/api/v2/products
PUT https://api.ecartapi.com/api/v2/products/{{id}}
Updates the product information, according to new detailed information.
Important information:
DELETE https://api.ecartapi.com/api/v2/products/{{id}}
Permanently delete the selected product.
Important information:
GET https://api.ecartapi.com/api/v2/products/{{productId}}/variants
Searches for all the registered variants of a single product.
Important information:
GET https://api.ecartapi.com/api/v2/products/{{productId}}/variants/{{id}}
Searches for the selected variant and shows the detailed information.
Important information:
GET https://api.ecartapi.com/api/v2/products/{{productId}}/variants/count
Counts all the registered variants of a single product.
Important information:
POST https://api.ecartapi.com/api/v2/products/{{productId}}/variants
Creates a variation of an available product.
Important information:
PUT https://api.ecartapi.com/api/v2/products/{{productId}}/variants/{{id}}
Updates the information of an already existing product variant
Important information:
DELETE https://api.ecartapi.com/api/v2/products/{{productId}}/variants/{{id}}
Permanently deletes a product's variation.
Important information:
GET https://api.ecartapi.com/api/v2/products/{{productId}}/images
Searches for all the images of a single product.
Important information:
GET https://api.ecartapi.com/api/v2/products/{{productId}}/images/{{id}}
Searches for all the images of a single product.
Important information:
POST https://api.ecartapi.com/api/v2/products/{{productId}}/images
Adds a new image to an existing product.
Important information:
DELETE https://api.ecartapi.com/api/v2/products/{{productId}}/images/{{id}}
Deletes permanently the selected image of a product.
Important information:
GET https://api.ecartapi.com/api/v2/categories
GET https://api.ecartapi.com/api/v2/categories/count
GET https://api.ecartapi.com/api/v2/categories/{{id}}
Searches for the selected category and shows detailed information.
Important information:
POST https://api.ecartapi.com/api/v2/categories
Creates new category.
PUT https://api.ecartapi.com/api/v2/categories/{{id}}
Update the selected category information.
Important information:
DELETE https://api.ecartapi.com/api/v2/categories/{{id}}
Permanently deletes the selected category.
Important information:
GET https://api.ecartapi.com/api/v2/customers
GET https://api.ecartapi.com/api/v2/customers/{{id}}
Searches for the selected customer and shows detailed information.
Important information:
GET https://api.ecartapi.com/api/v2/customers/count
POST https://api.ecartapi.com/api/v2/customers
Registers a new costumer.
Important information:
PUT https://api.ecartapi.com/api/v2/customers/{{id}}
Update the selected costumer's information.
Important information:
DELETE https://api.ecartapi.com/api/v2/customers/{{id}}
Permanently deletes the selected customer.
Important information:
GET https://api.ecartapi.com/api/v2/orders
GET https://api.ecartapi.com/api/v2/orders/count
GET https://api.ecartapi.com/api/v2/orders/{{id}}
Searches for a selected order and shows the detailed information.
Important information:
POST https://api.ecartapi.com/api/v2/orders
PUT https://api.ecartapi.com/api/v2/orders/{{id}}
Update an order's information.
Important information:
POST https://api.ecartapi.com/api/v2/orders/{{orderId}}/fulfillments
Creates an order's fulfillment.
Important information:
PUT https://api.ecartapi.com/api/v2/orders/{{orderId}}/fulfillments/{{id}}
Update the fulfillment information.
Important information:
POST https://api.ecartapi.com/api/v2/orders/{{orderId}}/fulfillments/{{id}}/cancel
Changes an order's fulfillment status to cancelled.
Important information:
POST https://api.ecartapi.com/api/v2/orders/{{orderId}}/fulfillments
Creates an order's fulfillment.
Important information:
PUT https://api.ecartapi.com/api/v2/orders/{{orderId}}/fulfillments/{{id}}
Update the fulfillment information.
Important information:
POST https://api.ecartapi.com/api/v2/orders/{{orderId}}/fulfillments/{{id}}/cancel
Changes an order's fulfillment status to cancelled.
Important information:
GET https://api.ecartapi.com/api/v2/store
GET https://api.ecartapi.com/api/v2/services/carriers
GET localhost:3000/api/v2/services/carriers/630e8e31ff7ed006b0976d41
POST https://api.ecartapi.com/api/v2/services/carriers
Create a service of carrier to quote shippings in checkout.
carrier.token: Utiliza este token por defecto (temporalmente): 4d225cdecfed20b84d7e7010c91ac214b58b07c7dd0f38fb7d56e4973213c705
PUT https://api.ecartapi.com/api/v2/services/carriers/630e8e31ff7ed006b0976d41
DELETE https://api.ecartapi.com/api/v2/services/carriers/630e8e31ff7ed006b0976d41
GET https://api.ecartapi.com/api/v2/products
This resource can show all products or filter the results with params
GET https://api.ecartapi.com/api/v2/products/{{id}}
Searches for a selected product and shows the detailed information.
Important information:
POST https://api.ecartapi.com/api/v2/products
Creates a new product and add to the store product list
PUT https://api.ecartapi.com/api/v2/products/{{id}}
Updates the product information, according to new detailed information.
Important information:
DELETE https://api.ecartapi.com/api/v2/products/{{id}}
Permanently delete the selected product.
Important information:
GET https://api.ecartapi.com/api/v2/products/{{productId}}/variants
Searches for all the registered variants of a single product.
Important information:
GET https://api.ecartapi.com/api/v2/products/{{productId}}/variants/{{id}}
Searches for the selected variant and shows the detailed information.
Important information:
POST https://api.ecartapi.com/api/v2/products/{{productId}}/variants
Creates a variation of an available product.
Important information:
DELETE https://api.ecartapi.com/api/v2/products/{{productId}}/variants/{{id}}
Permanently deletes a product's variation.
Important information:
GET https://api.ecartapi.com/api/v2/categories
Searches for all the available categories.
GET https://api.ecartapi.com/api/v2/categories/{{id}}
Searches for the selected category and shows detailed information.
Important information:
POST https://api.ecartapi.com/api/v2/categories
Creates a new category.
PUT https://api.ecartapi.com/api/v2/categories/{{id}}
Update the selected category information.
Important information:
DELETE https://api.ecartapi.com/api/v2/categories/{{id}}
Permanently deletes the selected category.
Important information:
GET https://api.ecartapi.com/api/v2/customers?page=String&limit=String
GET https://api.ecartapi.com/api/v2/customers/{{id}}
Searches for the selected customer and shows detailed information.
Important information:
POST https://api.ecartapi.com/api/v2/customers
Registers a new costumer.
Important information:
PUT https://api.ecartapi.com/api/v2/customers/{{id}}
Update the selected costumer's information.
Important information:
GET https://api.ecartapi.com/api/v2/orders
Retrieves all order information
GET https://api.ecartapi.com/api/v2/orders/{{id}}
Searches for a selected order and shows the detailed information.
Important information:
GET https://api.ecartapi.com/api/v2/orders/{{orderId}}/fulfillments
Shows all of the order's fulfillments detailed.
Important information:
GET https://api.ecartapi.com/api/v2/orders/{{orderId}}/fulfillments/{{id}}
Shows a selected order fulfillment with detail.
Important information:
PUT https://api.ecartapi.com/api/v2/orders/{{orderId}}/fulfillments/{{id}}
Update the fulfillment information.
Important information:
POST https://api.ecartapi.com/api/v2/orders/{{orderId}}/fulfillments
Creates an order's fulfillment.
Important information:
POST https://api.ecartapi.com/api/v2/orders/{{orderId}}/fulfillments/{{id}}/cancel
Cancels an order's fulfillment.
Important information:
GET https://api.ecartapi.com/api/v2/products
GET https://api.ecartapi.com/api/v2/products/{{id}}
POST https://api.ecartapi.com/api/v2/products
PUT https://api.ecartapi.com/api/v2/products/{{id}}
DELETE https://api.ecartapi.com/api/v2/products/{{id}}
POST https://api.ecartapi.com/api/v2/products/{{productId}}/images
Adds a new image to an existing product.
Important information:
GET https://api.ecartapi.com/api/v2/categories
GET https://api.ecartapi.com/api/v2/orders
GET https://api.ecartapi.com/api/v2/orders/{{id}}
POST https://api.ecartapi.com/api/v2/orders/{{orderId}}/fulfillments
GET https://api.ecartapi.com/api/v2/products
GET https://api.ecartapi.com/api/v2/products/:id
PUT https://api.ecartapi.com/api/v2/products/:id
GET https://api.ecartapi.com/api/v2/orders
GET https://api.ecartapi.com/api/v2/orders/:id
GET https://api.ecartapi.com/api/v2/fulfillments
GET https://api.ecartapi.com/api/v2/fulfillments/:id
POST https://api.ecartapi.com/api/v2/orders/:orderId/fulfillments
POST https://api.ecartapi.com/api/v2/orders/:orderId/fulfillments/:id/cancel
GET https://api.ecartapi.com/api/v2/fulfillments/api/v2/store
GET https://api.ecartapi.com/api/v2/orders/documents?orderIds=OrderId
This API endpoint performs an HTTP GET request to retrieve documents related to specific order ID.
The request should include the orderIds parameter with the relevant order ID.
Upon successful execution, the API returns a JSON response with a 200 status code and the following structure:
{
"success": true,
"document": {
"binary": "string",
"url": "string"
}
}
The response indicates the success status and provides information about the document, including a binary in base 64 representation and a URL.
GET https://api.ecartapi.com/api/v2/products
GET https://api.ecartapi.com/api/v2/products/{{id}}
GET https://api.ecartapi.com/api/v2/categories
GET https://api.ecartapi.com/api/v2/categories/{{id}}
PUT https://api.ecartapi.com/api/v2/categories/{{id}}
GET https://api.ecartapi.com/api/v2/orders
GET https://api.ecartapi.com/api/v2/orders/{{id}}
GET https://api.ecartapi.com/api/v2/customers
GET https://api.ecartapi.com/api/v2/customers/55487883
POST https://api.ecartapi.com/api/v2/customers
GET https://api.ecartapi.com/api/v1/orders/1/fulfillments
POST https://api.ecartapi.com/api/v2/orders/{{orderId}}/fulfillments
GET https://api.ecartapi.com/api/v2/products
GET https://api.ecartapi.com/api/v2/products/{{id}}
Searches for a selected product and shows the detailed information.
Important information:
GET https://api.ecartapi.com/api/v2/categories/{{id}}
Searches for the selected category and shows detailed information.
Important information:
GET https://api.ecartapi.com/api/v2/customers
GET https://api.ecartapi.com/api/v2/customers/{{id}}
Searches for the selected customer and shows detailed information.
Important information:
GET https://api.ecartapi.com/api/v2/orders
GET https://api.ecartapi.com/api/v2/orders/{{id}}
Searches for a selected order and shows the detailed information.
Important information:
GET https://api.ecartapi.com/api/v2/products
This request will return an array of products in a Magento Store, you can check the examples to see what kind of information Magento 2 returns in this request.
The product link included in the response sometimes might return a 404 error or it can redirect to another page.
NOTE: that the parameters in this request are the parametes this ecommerce supports to filter the results of this request.
GET https://api.ecartapi.com/api/v2/products/count
GET https://api.ecartapi.com/api/v2/products/{{id}}
Searches for a selected product and shows the detailed information.
Important information:
The product link included in the response sometimes might return a 404 error or it can redirect to another page.
POST https://api.ecartapi.com/api/v2/products
Creates a new product and add to the store product list.
PUT https://api.ecartapi.com/api/v2/products/{{id}}
Updates the product information, according to new detailed information.
Important information:
DELETE https://api.ecartapi.com/api/v2/products/{{id}}
Permanently delete the selected product.
Important information:
GET https://api.ecartapi.com/api/v2/products/1234L/variants
Searches for all the registered variants of a single product.
Important information:
GET https://api.ecartapi.com/api/v2/products/1234L/variants/llanta-LANVIGATOR-1
Searches for the selected variant and shows the detailed information.
Important information:
GET https://api.ecartapi.com/api/v2/categories
This resource can show all categories info.
GET https://api.ecartapi.com/api/v2/categories/{{id}}
Searches for the selected category and shows detailed information.
Important information:
POST https://api.ecartapi.com/api/v2/categories
Creates a new category.
PUT https://api.ecartapi.com/api/v2/categories/{{id}}
DELETE https://api.ecartapi.com/api/v2/categories/{{id}}
Permanently deletes the selected category.
Important information:
GET https://api.ecartapi.com/api/v2/customers
GET https://api.ecartapi.com/api/v2/customers/{{id}}
Searches for the selected customer and shows detailed information.
Important information:
POST https://api.ecartapi.com/api/v2/customers
PUT https://api.ecartapi.com/api/v2/customers/{{id}}
DELETE https://api.ecartapi.com/api/v2/customers/{{id}}
Permanently deletes the selected customer.
Important information:
GET https://api.ecartapi.com/api/v2/orders
This resource can show all orders information or filters the results with params.
GET https://api.ecartapi.com/api/v2/orders/{{id}}
Searches for a selected order and shows the detailed information.
Important information:
POST https://api.ecartapi.com/api/v2/orders
Creates new orders.
Important information:
PUT https://api.ecartapi.com/api/v2/orders/:id
Updates the order provided with the information sent in the payload.
status.status
allowed values:
on_hold, pending, paid, cancelled, refunded.
You will find the comparisson between the ecartapi status required to be sent on the payload and its Magento 2 equivalent with a short description.
EcartAPI | Magento 2 | Status description |
---|---|---|
on_hold | pending_payment | The payment is pending, and still to be paid |
pending | processing | The order is paid and is currently in process |
paid | processing | The order is paid and is currently in process |
cancelled | canceled | The order has been cancelled |
refunded | refunded | The payment has been refunded |
GET https://api.ecartapi.com/api/v2/orders/{{orderId}}/fulfillments
Shows all of the order's fulfillments detailed.
Important information:
Filter | Description |
limit |
Limit size of the search |
'createdAt[from]' |
Filter customers by date created from. When used createdAt[to] |
'createdAt[to]' |
Filter customers by date created to. When used createdAt[from] |
'updatedAt[from]' |
Filter customers by date updated from. When used createdAt[to] |
'updatedAt[to]' |
Filter customers by date updated to. When used createdAt[from] |
GET https://api.ecartapi.com/api/v2/orders/{{orderId}}/fulfillments/{{id}}
Shows a selected order fulfillment with detail.
Important information:
POST https://api.ecartapi.com/api/v2/orders/{{orderId}}/fulfillments
Creates an order's fulfillment.
Important information:
POST https://api.ecartapi.com/api/v2/orders/{{orderId}}/fulfillments/{{id}}/cancel
Cancels an order's fulfillment.
Important information:
GET https://api.ecartapi.com/api/v2/store
This API endpoint makes an HTTP GET request to retrieve information about a store.
The response to this request will have a status code of 200 if the request is successful. The response body will contain a JSON object with the following properties:
success
: A boolean value indicating whether the request was successful or not.store
: An object representing the store. It has the following properties:
id
: The ID of the store.name
: The name of the store.ecommerce
: The type of ecommerce platform used by the store.email
: The email address associated with the store.url
: The URL of the store.address
: An object representing the store's address. It has the following properties:
id
: The ID of the address.address1
: The first line of the address.address2
: The second line of the address.address3
: The third line of the address.country
: An object representing the country of the address. It has the following properties:
code
: The code of the country.name
: The name of the country.codeIso2
: The ISO 2-letter code of the country.codeIso3
: The ISO 3-letter code of the country.state
: An object representing the state of the address. It has the following properties:
code
: The code of the state.name
: The name of the state.codeIso2
: The ISO 2-letter code of the state.codeIso3
: The ISO 3-letter code of the state.city
: The city of the address.postalCode
: The postal code of the address.phone
: The phone number associated with the address.currency
: The currency used by the store.units
: An object representing the units used by the store. It has the following properties:
width
: The unit used for width measurements.height
: The unit used for height measurements.length
: The unit used for length measurements.weight
: The unit used for weight measurements.coordinates
: An object representing the coordinates of the store's location. It has the following properties:
latitude
: The latitude of the location.longitude
: The longitude of the location.pages
: An array of pages associated with the store.plan
: The plan of the store.logistic
: An object representing the logistics information of the store. It has the following properties:
me1Supported
: The ME1 shipping support status of the store.modes
: An array of shipping modes supported by the store.Here is an example response for this request:
{
"success": true,
"store": {
"id": "",
"name": null,
"ecommerce": null,
"email": "",
"url": "",
"address": {
"id": null,
"address1": "",
"address2": null,
"address3": null,
"country": {
"code": "",
"name": "",
"codeIso2": "",
"codeIso3": ""
},
"state": {
"code": null,
"name": "",
"codeIso2": null,
"codeIso3": null
},
"city": "",
"postalCode": "",
"phone": ""
},
"currency": null,
"units": {
"width": null,
"height": null,
"length": null,
"weight": null
},
"coordinates": {
"latitude": null,
"longitude": null
},
"pages": [],
"plan": null,
"logistic": {
"me1Supported": "",
"modes": [""]
}
}
}
Please note that the values in the example response are placeholders and may not represent actual data.
GET https://api.ecartapi.com/api/v2/categories?siteId={{id}}
GET https://api.ecartapi.com/api/v2/categories/{{id}}
Searches for the selected category and shows detailed information.
Important information:
GET https://api.ecartapi.com/api/v2/products
This API endpoint makes an HTTP GET request to retrieve a list of products.
Query parameters:
productType
: This parameter is used to filter the products based on their type.status[active]
: This parameter is used to filter the products based on their status, specifically for active products.Response details:
success
: A boolean value indicating the success of the request.products
: An array of product objects, each containing the following properties:
id
: The unique identifier of the product.sku
: The stock keeping unit (SKU) of the product.name
: The name of the product.subName
: The subname of the product.upc
: The universal product code (UPC) of the product.gtin
: The global trade item number (GTIN) of the product.description
: The description of the product.currency
: The currency used for pricing the product.productType
: The type of the product.quantity
: The quantity of the product.price
: The price of the product.cost
: The cost of the product.discount
: The discount applied to the product.dimensions
: An object representing the dimensions of the product, including width, height, length, and weight.units
: An object representing the units of measurement for the product dimensions, including width, height, length, and weight.category
: An object representing the category of the product, including the category ID and name.tags
: An array of tags associated with the product.status
: An object representing the status of the product, including the status ID, visibility, active status, ecartapi ID, ecartapi, and whether the product has options.variants
: An array of variant objects associated with the product, each containing properties such as variant ID, product ID, barcode, name, price, currency, fulfillment service, options, dimensions, units, inventory, status, shipping requirements, bundled status, country and province codes, harmonized system code, image ID, image URL, and dates.options
: An array of option objects associated with the product, each containing a name and an array of values.associatedItems
: An array of associated item objects.logistic
: An object representing the logistic details of the product, including ME1 support, mode, type, free shipping, direction, dimensions, and rates.images
: An array of image objects associated with the product, each containing an ID, URL, variant IDs, and ecartapi URL.imageUrl
: The URL of the product image.condition
: The condition of the product.link
: The link to the product.dates
: An object representing the creation and update dates of the product.vendor
: The vendor of the product.sellOutStock
: The stock status of the product.locations
: An array of location objects associated with the product, each containing properties such as location ID, name, address, country, state, city, postal code, phone number, company, references, product IDs, default status, latitude, longitude, and ecartapi URL.internationalShipment
: An array of international shipment objects associated with the product.Additionally, the response includes a page
object with the next
property indicating the URL for the next page of results, and the previous
property indicating the URL for the previous page of results.
Please note that some properties may have null values depending on the availability of data for each product.
GET https://api.ecartapi.com/api/v2/products/:id
POST https://api.ecartapi.com/api/v2/products
PUT https://api.ecartapi.com/api/v2/products/{{id}}
*Update a product
*
This feature allows you to update the following product properties:
When the item is active you can modify:
When the item does not have sales, you can modify:
Consider the following conditions when updating logistics:
The ME1 shipping mode enables sellers to list heavy or bulky products on Mercado Libre. With this option, sellers can manage their own logistics or use third-party services for products that do not qualify for Mercado Shipments 2 (ME2).
When using the dimensions and units properties in this resource, it pertains to the dimensions and units of the package for the ME1 shipping method, as illustrated in the example.
The dimensions and units for products are managed directly by MercadoLibre based on the category and type of the product when it was created.
For ME1 object dimensions are required.
Dimensions limit for ME1 mode:
If you break the limit of some previous metric the shipping mode will be not_specifcied.
For the ME2 shipping mode, it's important to remember that the dimensions of the packages are determined by Mercado Libre and cannot be altered by the user.
This shipping method is valid for the following countries: Argentina, Brazil, Colombia, Mexico, Chile, Uruguay, Peru, and Ecuador.
It is not possible to change a product in shipping mode ME2 to ME1.With the custom shipping method, you can establish multiple rates, enabling buyers to select the option that best fits their needs at the time of purchase. This feature is especially valuable when sellers opt to manage their own logistics for their sales.
More information about the ecommerce's resource.
Consider the following conditions when updating inventory:
To update quantity to a flex product the productUserId is required. To get it, use the get product call.
DELETE https://api.ecartapi.com/api/v2/products/{{id}}
Permanently delete the selected product.
Important information:
GET https://api.ecartapi.com/api/v2/products/{{productId}}/images/{{id}}
Searches for the selected image of a product.
Important information:
GET https://api.ecartapi.com/api/v2/products/{{productId}}/variants
Searches for all the registered variants of a single product.
Important information:
GET https://api.ecartapi.com/api/v2/products/{{productId}}/variants/{{id}}
Searches for a selected variant of a product.
Important information:
GET https://api.ecartapi.com/api/v2/orders/{{id}}/risks
Retrieves all risks of a order.
GET https://api.ecartapi.com/api/v2/orders/{{orderId}}/risks/{{id}}
Retrieve a single risk for a order sending the ID as required path param
POST https://api.ecartapi.com/api/v2/orders/{{orderId}}/risks
post a message to tag a risk for an order
DELETE https://api.ecartapi.com/api/v2/orders/{{orderId}}/risks/{{id}}
Permanently deletes the selected order risk
GET https://api.ecartapi.com/api/v2/orders
Filter | Description |
sort |
Order search result by ascending:'date_asc' or descending:'date_desc' |
limit |
Limit size of the search |
'createdAt[from]' |
Filter orders by date created from. When used createdAt[to] |
'createdAt[to]' |
Filter orders by date created to. When used createdAt[from] |
'status[status]' |
Filter orders by status: Pending, Shipped, Canceled |
'updatedAt[from]' |
Filter orders by date updated from. When used createdAt[to] |
'updatedAt[to]' |
Filter orders by date updated to. When used createdAt[from] |
search |
Filter orders by a text chain |
recent |
Filter recent orders |
page |
Pagination number. |
GET https://api.ecartapi.com/api/v2/orders/{{id}}
Searches for a selected order and shows the detailed information.
Important information:
You can use the shippingLabel
parameter as a reference to download the shipping document of the order. If this parameter is not NULL
then you will receive the endpoint to make GET request to download the shipping document, in the Mercado Libre response you will receive a blob that you can convert into a pdf
GET https://api.ecartapi.com/api/v2/orders/{{orderId}}/fulfillments/{{id}}
GET https://api.ecartapi.com/api/v2/orders/{{orderId}}/fulfillments
POST https://api.ecartapi.com/api/v2/orders/:orderId/fulfillments
POST https://api.ecartapi.com/api/v2/orders/:orderId/fulfillments/events
Allowed values for status and meaning:
Ecartapi status | E-commerce status | E-commerce Description |
---|---|---|
delivered | delivered | The shipment was successfully delivered. |
failed | failure | Something went wrong with the shipment it was no delivered or sent back to the seller. |
in_transit | in_transit | The shipment is being transported between shipping facilities on the way to its destination. |
Find more information of the resource on the ecommerce documentation.
GET https://api.ecartapi.com/api/v2/locations
GET https://api.ecartapi.com/api/v2/locations/:id
GET https://api.ecartapi.com/api/v2/products
PUT https://api.ecartapi.com/api/v2/locations/X/inventories/MLAU1106141798
GET https://api.ecartapi.com/api/v2/shippings?categoryId=MLM27576
Retrieves store shippings available
categoryId: Get shippings modes available for a product category.
GET https://api.ecartapi.com/api/v2/orders/documents?fulfillmentIds=43879983966&type=zpl2
This call has required param fulfillmentIds
you can ask for a different type of document with the param type
there is PDF and ZPL2
GET https://api.ecartapi.com/api/v2/packs/{{packID}}/messages
To send messages with your client first you must have the packId and the customer ID both can be found when making a get single order request.
GET https://api.ecartapi.com/api/v2/packs/{{packID}}/messages/{{id}}
To send messages with your client first you must have the packId and the customer ID both can be found when making a get single order request.
POST https://api.ecartapi.com/api/v2/packs/{{packId}}/messages
To send messages with your client first you must have the packId and the customer ID both can be found when making a get single order request.
OPTIONS https://api.ecartapi.com/api/v2/webhooks
GET https://api.ecartapi.com/api/v2/webhooks
GET https://api.ecartapi.com/api/v2/webhooks/{{id}}
POST https://api.ecartapi.com/api/v2/webhooks
PUT https://api.ecartapi.com/api/v2/webhooks/{{id}}
DELETE https://api.ecartapi.com/api/v2/webhooks/{{id}}
POST localhost:3000/api/v2/refreshtoken
GET https://api.ecartapi.com/api/v2/categories
Searches for all the available categories.
GET https://api.ecartapi.com/api/v2/categories/08a55a28-29e3-4a15-86a5-291239dad46a
Searches for the selected category and shows detailed information.
Important information:
POST https://api.ecartapi.com/api/v2/categories
Creates a new category.
PUT https://api.ecartapi.com/api/v2/categories/a0f02dda-4e38-4dde-9f5a-52f7dc978712
GET https://api.ecartapi.com/api/v2/customers
This resource can show all customers information or filters the results with params.
GET https://api.ecartapi.com/api/v2/customers/8649040d-923b-44d4-9d18-3325212d8ef3
Searches for the selected customer and shows detailed information.
Important information:
POST https://api.ecartapi.com/api/v2/customers
Registers a new costumer
GET https://api.ecartapi.com/api/v2/orders/documents
Get an url for get a compress file with documents about the shipping.
requestId: required
POST https://api.ecartapi.com/api/v2/orders/documents
Use for falabella, dafiti y linio
orderId: is required
GET https://api.ecartapi.com/api/v2/orders/{{orderId}}/fulfillments/{{id}}
This resource can show an order fulfillments information.
Important information:
POST https://api.ecartapi.com/api/v2/orders
GET https://api.ecartapi.com/api/v2/orders
Retrieves all orders information.
POST https://api.ecartapi.com/api/v1/orders
GET https://api.ecartapi.com/api/v1/payments
Get all payments methods.
GET https://api.ecartapi.com/api/v2/products
StartFragment
This resource can show all products or filters the results with params.
EndFragme
GET https://api.ecartapi.com/api/v2/products/85bb88af-2e31-475e-b4cf-8155a499fb79
Searches for a selected product and shows the detailed information.
Important information:
POST https://api.ecartapi.com/api/v2/products
Creates a new product and add to the store product list.
PUT https://api.ecartapi.com/api/v2/products/4e20ec13-38b5-4603-a06d-0bba110356c8
Updates the product information, according to new detailed information.
Important information:
GET https://api.ecartapi.com/api/v2/shippings
Retrieves all store shipping methods.
GET https://api.ecartapi.com/api/v2/store
StartFragment
Retrieves store information.
EndFragm
GET https://api.ecartapi.com/api/v2/locations
This API endpoint is part of the ecartapi solution, which is compatible with various e-commerce platforms, including Multivende. It provides a list of available warehouses for the queried merchant.
For reference you can find the Multivende resource endpoint here.
POST https://api.ecartapi.com/api/v2/locations
This API endpoint is a feature of the ecartapi solution, designed to work seamlessly with multiple e-commerce platforms, such as Multivende. It enables users to create a new warehouse by providing essential location details in a JSON request.
For reference find de multivende documentation for this endpoint here.
GET https://api.ecartapi.com/api/v2/locations/615633ab-38ef-4ce2-9313-e57243b9cb4c/inventories
This API endpoint is an integral part of the ecartapi solution, which offers compatibility with various e-commerce platforms, including Multivende. It allows you to retrieve stock information from a specific location.
This is a reference link to the resource from multivende documentation.
PUT https://api.ecartapi.com/api/v2/locations/{{locationId}}/inventories/{{inventoryId}}
This API endpoint is a crucial feature within the ecartapi solution, designed to seamlessly work with multiple e-commerce platforms, including Multivende. It enables you to modify the quantity of items in stock at a specific location.
This is a reference link to the resource from multivende documentation.
GET https://api.ecartapi.com/api/v2/locations/3f09d1cf-94af-47a7-867e-3ce7637f78ab/inventories/9789566196620
GET https://api.ecartapi.com/api/v2/products
GET https://api.ecartapi.com/api/v2/products/{{id}}
Searches for a selected product and shows the detailed information.
Important information:
GET https://api.ecartapi.com/api/v2/products/count
POST https://api.ecartapi.com/api/v2/products
PUT https://api.ecartapi.com/api/v2/products/{{id}}
Updates the product information, according to new detailed information.
Important information:
DELETE https://api.ecartapi.com/api/v2/products/4469858631754
Permanently delete the selected product.
Important information:
GET https://api.ecartapi.com/api/v2/categories
GET https://api.ecartapi.com/api/v2/categories/count
GET https://api.ecartapi.com/api/v2/categories/{{id}}
Searches for the selected category and shows detailed information.
Important information:
POST https://api.ecartapi.com/api/v2/categories
Creates new category.
PUT https://api.ecartapi.com/api/v2/categories/{{id}}
Update the selected category information.
Important information:
DELETE https://api.ecartapi.com/api/v2/categories/{{id}}
Permanently deletes the selected category.
Important information:
GET https://api.ecartapi.com/api/v2/customers
GET https://api.ecartapi.com/api/v2/customers/{{id}}
Searches for the selected customer and shows detailed information.
Important information:
GET https://api.ecartapi.com/api/v2/customers/count
POST https://api.ecartapi.com/api/v2/customers
Registers a new costumer.
Important information:
PUT https://api.ecartapi.com/api/v2/customers/{{id}}
Update the selected costumer's information.
Important information:
DELETE https://api.ecartapi.com/api/v2/customers/{{id}}
Permanently deletes the selected customer.
Important information:
GET https://api.ecartapi.com/api/v2/orders
GET https://api.ecartapi.com/api/v2/orders/count
GET https://api.ecartapi.com/api/v2/orders/{{id}}
Searches for a selected order and shows the detailed information.
Important information:
POST https://api.ecartapi.com/api/v2/orders
PUT https://api.ecartapi.com/api/v2/orders/{{id}}
Update an order's information.
Important information:
DELETE https://api.ecartapi.com/api/v2/orders/{{id}}
Permanently deletes the selected order.
Important information:
GET https://api.ecartapi.com/api/v2/orders/{{orderId}}/fulfillments
Shows all of the order's fulfillments detailed.
Important information:
GET localhost:3000/api/v2/orders/{{orderId}}/fulfillments/{{id}}
Shows a selected order fulfillment with detail.
Important information:
POST https://api.ecartapi.com/api/v2/orders/{{orderId}}/fulfillments
package.dimensions.weight
- represents the weight of the package to be shipped.
tracking.number
- Tracking number assigned to the shipping label generated for this fulfillments package.
PUT https://api.ecartapi.com/api/v2/orders/{{orderId}}/fulfillments/{{id}}
Update the fulfillment information.
Important information:
GET https://api.ecartapi.com/api/v2/products
GET https://api.ecartapi.com/api/v2/products/{{id}}
GET https://api.ecartapi.com/api/v2/orders
GET https://api.ecartapi.com/api/v2/orders/{{id}}
POST https://api.ecartapi.com/api/v2/orders
PUT https://api.ecartapi.com/api/v2/orders/{{id}}
Update orders information.
When notification is set to true the client of the order will receive and email regarding their order being updated.
Allowed values for body.
status.status
- paid, pending, refunded, cancelled, deleted, authorized, shipped:
DELETE https://api.ecartapi.com/api/v2/orders/{{id}}
GET https://api.ecartapi.com/api/v2/carts
POST https://api.ecartapi.com/api/v2/orders/{{orderId}}/fulfillments
This request updates Opencart's order status to shipped and sets a comment for the store manager that includes the carrier, tracking number and url.
The order's ID must exist
'shipped'
in opencart.
POST https://api.ecartapi.com/api/v2/refreshtoken
GET htpps://api.ecartapi.com/api/v2/store
GET htpps://api.ecartapi.com/api/v2/products
GET htpps://api.ecartapi.com/api/v2/products/{{productId}}
POST htpps://api.ecartapi.com/api/v2/products
Accounts is an object that you can use to reference IncomeAccount, AssetAccount, and ExpenseAccount. This allows you to properly organize the creation of your product if you don't use the default accounts within your QuickBooks store.
If you prefer to use QuickBooks' default accounts or don't have accounts created, you don't need to enter the accounts object. The object will be created with QuickBooks' default values.
PUT htpps://api.ecartapi.com/api/v2/products/{{productId}}
DELETE htpps://api.ecartapi.com/api/v2/products/{{productId}}
GET htpps://api.ecartapi.com/api/v2/orders
GET htpps://api.ecartapi.com/api/v2/orders/{{orderId}}
POST htpps://api.ecartapi.com/api/v2/orders
To obtain a TaxCodeId, please use our taxes resource. This will allow you to add the tax to your order.
PUT htpps://api.ecartapi.com/api/v2/orders/{{orderId}}
DELETE htpps://api.ecartapi.com/api/v2/orders/{{orderId}}
GET htpps://api.ecartapi.com/api/v2/taxes/taxAgencies
GET htpps://api.ecartapi.com/api/v2/taxes/taxAgencies/{{id}}
POST htpps://api.ecartapi.com/api/v2/taxes/taxAgencies
GET htpps://api.ecartapi.com/api/v2/taxes/taxCodes
GET htpps://api.ecartapi.com/api/v2/taxes/taxCodes/{{id}}
POST htpps://api.ecartapi.com/api/v2/taxes/taxCodes
GET htpps://api.ecartapi.com/api/v2/taxes/taxRates
GET htpps://api.ecartapi.com/api/v2/taxes/taxRates/{{id}}
GET htpps://api.ecartapi.com/api/v2/customers/{{id}}
POST htpps://api.ecartapi.com/api/v2/customers
PUT htpps://api.ecartapi.com/api/v2/customers/{{id}}
DELETE htpps://api.ecartapi.com/api/v2/customers/{{id}}
GET https://api.ecartapi.com/api/v2/customers
GET htpps://api.ecartapi.com/api/v2/webhooks
GET htpps://api.ecartapi.com/api/v2/webhooks/{{id}}
POST htpps://api.ecartapi.com/api/v2/webhooks
PUT htpps://api.ecartapi.com/api/v2/webhooks/{{id}}
DELETE htpps://api.ecartapi.com/api/v2/webhooks/{{id}}
GET https://api.ecartapi.com/api/v2/products
This resource can show all products or filters the results with params.
GET https://api.ecartapi.com/api/v2/products/{{id}}
Searches for a selected product and shows the detailed information.
Important information:
POST https://api.ecartapi.com/api/v2/products
Creates a new product and add to the store product list.
PUT https://api.ecartapi.com/api/v2/products/{{id}}
Updates the product information, according to new detailed information.
Important information:
DELETE https://api.ecartapi.com/api/v2/products/{{id}}
Permanently delete the selected product.
Important information:
GET https://api.ecartapi.com/api/v2/products/{{productId}}/variants
Searches for all the registered variants of a single product.
Important information:
GET https://api.ecartapi.com/api/v2/products/{{productId}}/variants/{{id}}
Searches for the selected variant and shows the detailed information.
Important information:
POST https://api.ecartapi.com/api/v2/products/{{productId}}/variants
Creates a variation of an available product.
Important information:
PUT https://api.ecartapi.com/api/v2/products/{{productId}}/variants/{{id}}
Creates a variation of an available product.
Important information:
DELETE https://api.ecartapi.com/api/v2/products/{{productId}}/variants/{{id}}
Permanently deletes a product's variation.
Important information:
GET https://api.ecartapi.com/api/v2/products/{{productId}}/images
Searches for all the images of a single product.
Important information:
GET https://api.ecartapi.com/api/v2/products/{{productId}}/images/{{id}}
Searches for the selected image of a product.
Important information:
GET https://api.ecartapi.com/api/v2/categories
This resource can show all categories info.
GET https://api.ecartapi.com/api/v2/categories/{{id}}
Searches for the selected category and shows detailed information.
Important information:
POST https://api.ecartapi.com/api/v2/categories
Creates a new category.
PUT https://api.ecartapi.com/api/v2/categories/{{id}}
Update the selected category information.
Important information:
DELETE https://api.ecartapi.com/api/v2/categories/{{id}}
Permanently deletes the selected category.
Important information:
GET https://api.ecartapi.com/api/v2/orders
This resource can show all orders information or filters the results with params.
GET https://api.ecartapi.com/api/v2/orders/{{id}}
Searches for a selected order and shows the detailed information.
Important information:
DELETE https://api.ecartapi.com/api/v2/orders/{{id}}
Permanently deletes the selected order.
Important information:
GET https://api.ecartapi.com/api/v2/customers
This resource can show all customers information or filters the results with params.
GET https://api.ecartapi.com/api/v2/customers/{{id}}
Searches for the selected customer and shows detailed information.
Important information:
POST https://api.ecartapi.com/api/v2/customers
Registers a new costumer.
Important information:
PUT https://api.ecartapi.com/api/v2/customers/{{id}}
Updatethe selected costumer's information.
Important information:
DELETE https://api.ecartapi.com/api/v2/customers/{{id}}
Permanently deletes the selected customer.
Important information:
GET https://api.ecartapi.com/api/v2/carts
This resource can show all carts.
GET https://api.ecartapi.com/api/v2/carts/{{id}}
Searches for the selected cart and shows detailed information.
Important information:
DELETE https://api.ecartapi.com/api/v2/carts/{{id}}
Permanently deletes the selected cart.
Important information:
POST https://api.ecartapi.com/api/v2/orders/{{orderId}}/fulfillments
Get companyId of carrier using Get all carriers service.
If companyId does not have your carrier pick and ID to represent your carrier and ask the seller to add it into their store settings.
GET {{hostname}}/api/v2/orders/27/fulfillments
This resource can show an order fulfillments information.
Important information:
GET localhost:3000/api/v2/orders/services/fulfillment
GET https://api.ecartapi.com/api/v2/orders/carriers
This resource show all carriers information or filters the results with params.
POST https://api.ecartapi.com/api/v2/orders/{{orderId}}/fulfillments/{{id}}/cancel
POST {{hostname}}/api/v2/webhooks
GET https://api.ecartapi.com/api/v2/addresses
GET https://api.ecartapi.com/api/v2/addresses/137
GET https://api.ecartapi.com/api/v2/products
GET https://api.ecartapi.com/api/v2/products/{{id}}
GET https://api.ecartapi.com/api/v2/products/count
POST https://api.ecartapi.com/api/v2/products
PUT https://api.ecartapi.com/api/v2/products/{{id}}
GET https://api.ecartapi.com/api/v2/orders
GET https://api.ecartapi.com/api/v2/orders/{{id}}
GET https://api.ecartapi.com/api/v2/orders/count
POST https://api.ecartapi.com/api/v2/orders
PUT https://api.ecartapi.com/api/v2/orders/{{id}}
GET https://api.ecartapi.com/api/v2/customers
GET https://api.ecartapi.com/api/v2/customers/{{id}}
GET https://api.ecartapi.com/api/v2/customers/count
POST https://api.ecartapi.com/api/v2/customers
PUT https://api.ecartapi.com/api/v2/customers/{{id}}
POST localhost:3000/api/v2/refreshtoken
GET https://api.ecartapi.com/api/v2/products
Filter | Description |
page |
Pagination number. |
limit |
Limit size of the search |
GET https://api.ecartapi.com/api/v2/products/{{id}}
POST https://api.ecartapi.com/api/v2/products
GET https://api.ecartapi.com/api/v2/orders
Filter | Description |
limit |
Limit size of the search |
page |
Pagination number. |
GET https://api.ecartapi.com/api/v2/orders/{{id}}
POST https://api.ecartapi.com/api/v2/orders
PUT https://api.ecartapi.com/api/v2/orders/{{id}}
POST https://api.ecartapi.com/api/v2/refreshtoken
POST https://api.ecartapi.com/api/v2/webhooks
Requirements:
Before we start setting up the Shopify GDPR webhooks first you need to already have all of the following:
A Shopify access token.
An App in Shopify's Partner program.
An Endpoint on your app to receive webhook information.
Setting Up Webhooks on EcartAPI:
Create the 3 types of GDPR webhooks through EcartAPI using a POST request. Make sure to save the gdprReference
for each webhook.
Set up your GDPR URL for Shopify as follows:
- URL format: `https://api.ecartapi.com/api/v2/webhooks/shopify/callback/{{gdprReference}}/{{webhook_type}}`
- Replace the information within the double curly braces `{{ }}` with the appropriate values:
- `{{gdprReference}}` with the `gdprReference` you saved in step 1.
- `{{webhook_type}}` with the specific type of GDPR webhook (_"customer_request", "customer_redact", "shop_redact"_).
Now, let's proceed to configure these webhooks in your Shopify Partner Dashboard:
Configuring Webhooks in Shopify Partner Dashboard:
Log in to your Shopify Partner Dashboard.
Go to Apps
in the Partner Dashboard.
Locate and click on the specific app that you want to update.
Inside the app, find and click on App setup.
In the GDPR mandatory webhooks section, update the endpoints for the three GDPR webhook types with the URLs you generated in step 2.
After updating the endpoints, click Save
to save your changes.
These steps ensure that your EcartAPI app is set up to receive GDPR webhooks from Shopify. Once configured, Shopify will send webhook events to the specified URLs, and your EcartAPI app can process the incoming data as needed.
Remember that you only need to set up these webhooks once, as duplicate setups can lead to duplicated requests. Make sure to handle the incoming webhook data in your EcartAPI app as per your requirements for GDPR compliance.
GET https://api.ecartapi.com/api/v2/store/billing
GET https://api.ecartapi.com/api/v2/store/billing/{{id}}
POST https://api.ecartapi.com/api/v2/store/billing
GET https://api.ecartapi.com/api/v2/billing/recurrent
GET https://api.ecartapi.com/api/v2/billing/recurrent/{{id}}
GET https://api.ecartapi.com/api/v2/billing/recurrent/{{id}}/activate
POST https://api.ecartapi.com/api/v2/billing/recurrent
GET https://api.ecartapi.com/api/v2/billing/{{id}}/usage
To make usage charges you must create a recurrent billing and activate it so you can charge the store
GET https://api.ecartapi.com/api/v2/billing/{{id}}/usage/{{usageId}}
To make usage charges you must create a recurrent billing and activate it so you can charge the store
POST https://api.ecartapi.com/api/v2/billing/{{id}}/usage
To make usage charges you must create a recurrent billing and activate it so you can charge the store
GET https://api.ecartapi.com/api/v2/store
GET https://api.ecartapi.com/api/v2/store/feedback
POST https://api.ecartapi.com/api/v2/store/feedback
POST https://api.ecartapi.com/api/v2/store/token
GET https://api.ecartapi.com/api/v2/products
Filter | Description |
page | Pagination number. |
limit | Limit size of the search |
ids | Filter items by Id's provided |
sinceId | Filter items since the Id given |
name | Filter items by name |
productType | Filter items by type of product |
categoryId | Filter items by id of products category |
'createdAt[from]' | Filter items by date created from. When used createdAt[to] |
'createdAt[to]' | Filter items by date created to. When used createdAt[from] |
'updatedAt[from]' | Filter items by date updated from. When used createdAt[to] |
'updatedAt[to]' | Filter items by date updated to. When used createdAt[from] |
'status[active]' | Filter items by status pf published: 'true' or 'false' |
GET https://api.ecartapi.com/api/v2/products/{{id}}
Searches for a selected product and shows the detailed information.
Important information:
Dimensions in products are only available for variants. When there are different values in the variants, it will always display those of the first one.
GET https://api.ecartapi.com/api/v2/products/count
POST https://api.ecartapi.com/api/v2/products
Creates a new product.
Options: Only is possible creates the first variant usign *create product*, and will be created with the first values o each option.
Use variant resource to create more product variants.
PUT https://api.ecartapi.com/api/v2/products/{{id}}
Allowed values for satus.active
: (Boolean string)
"true"
false
If you want to update the price or inventory of a product, you must use the 'update product variant' resource.
DELETE https://api.ecartapi.com/api/v2/products/{{id}}
Permanently delete the selected product.
Important information:
GET https://api.ecartapi.com/api/v2/products/{{productId}}/variants
Searches for all the registered variants of a single product.
Important information:
GET https://api.ecartapi.com/api/v2/products/{{productId}}/variants/{{id}}
Searches for the selected variant and shows the detailed information.
Important information:
GET https://api.ecartapi.com/api/v2/products/{{productId}}/variants/count
Counts all the registered variants of a single product.
Important information:
POST https://api.ecartapi.com/api/v2/products/{{productId}}/variants
PUT https://api.ecartapi.com/api/v2/products/{{productId}}/variants/{{id}}
DELETE https://api.ecartapi.com/api/v2/products/{{productId}}/variants/{{id}}
Permanently deletes a product's variation.
Important information:
GET https://api.ecartapi.com/api/v2/products/{{productId}}/images
Searches for all the images of a single product.
Important information:
GET https://api.ecartapi.com/api/v2/products/{{productId}}/images/{{id}}
Searches for all the images of a single product.
Important information:
POST https://api.ecartapi.com/api/v2/products/{{productId}}/images
Adds a new image to an existing product.
Important information:
DELETE https://api.ecartapi.com/api/v2/products/{{productId}}/images/{{id}}
Deletes permanently the selected image of a product.
Important information:
GET https://api.ecartapi.com/api/v2/products/listings?limit=3&page=page-token&updatedAt[from]=2020-08-21
GET https://api.ecartapi.com/api/v2/products/listings/count
GET https://api.ecartapi.com/api/v2/products/listings/{{id}}
POST https://api.ecartapi.com/api/v2/products/listings
DELETE https://api.ecartapi.com/api/v2/products/listings/{{id}}
GET https://api.ecartapi.com/api/v2/products/{{id}}/feedback
POST https://api.ecartapi.com/api/v2/products/{{productId}}/feedback
GET https://api.ecartapi.com/api/v2/categories
Filter | Description |
ids |
Filter categories by Id's provided |
limit |
Limit size of the search |
page |
Pagination number. |
sinceId |
Filter categories since the Id given |
name |
Filter categories by name |
productID |
Filter by product id |
GET https://api.ecartapi.com/api/v2/categories/count
GET https://api.ecartapi.com/api/v2/categories/{{id}}
Searches for the selected category and shows detailed information.
Important information:
POST https://api.ecartapi.com/api/v2/categories
Creates new category.
PUT https://api.ecartapi.com/api/v2/categories/{{id}}
Update the selected category information.
Important information:
DELETE https://api.ecartapi.com/api/v2/categories/{{id}}
Permanently deletes the selected category.
Important information:
GET https://api.ecartapi.com/api/v2/customers
Filter | Description |
ids |
Filter customers by Id's provided |
limit |
Limit size of the search |
page |
Pagination number. |
sinceId |
Filter customers since the Id given |
'createdAt[from]' |
Filter customers by date created from. When used createdAt[to] |
'createdAt[to]' |
Filter customers by date created to. When used createdAt[from] |
'updatedAt[from]' |
Filter customers by date updated from. When used createdAt[to] |
'updatedAt[to]' |
Filter customers by date updated to. When used createdAt[from] |
GET https://api.ecartapi.com/api/v2/customers/{{id}}
Searches for the selected customer and shows detailed information.
Important information:
GET https://api.ecartapi.com/api/v2/customers/count
POST https://api.ecartapi.com/api/v2/customers
Registers a new costumer.
Important information:
PUT https://api.ecartapi.com/api/v2/customers/{{id}}
Update the selected costumer's information.
Important information:
DELETE https://api.ecartapi.com/api/v2/customers/{{id}}
Permanently deletes the selected customer.
Important information:
GET https://api.ecartapi.com/api/v2/orders/{{orderId}}/risks
Retrieves all risks of a order.
GET https://api.ecartapi.com/api/v2/orders/{{orderId}}/risks/{{id}}
Retrieve a single risk for a order sending the ID as required path param
POST https://api.ecartapi.com/api/v2/orders/{{orderId}}/risks
DELETE https://api.ecartapi.com/api/v2/orders/5058721448191/risks/7550661394687
GET https://api.ecartapi.com/api/v2/orders
Get's all orders from the shopify store.
GET https://api.ecartapi.com/api/v2/orders/count
GET https://api.ecartapi.com/api/v2/orders/{{id}}
Searches for a selected order and shows the detailed information.
Important information:
Params:
draft ( Boolean )
-
Returns only draft order.
POST https://api.ecartapi.com/api/v2/orders
Creates order based on information provided. You can create draft orders.
Important information:
Params:
draft ( Boolean )
-
Creates draft order when true.
PUT https://api.ecartapi.com/api/v2/orders/{{id}}
Update an order's information.
Important information:
Params:
draft ( Boolean )
-
Updates draft order when true.
DELETE https://api.ecartapi.com/api/v2/orders/{{id}}
Permanently deletes the selected order.
Important information:
POST https://api.ecartapi.com/api/v2/orders/{{id}}/complete
Complete draft order as paid.
Important information:
GET https://api.ecartapi.com/api/v2/orders/{{orderId}}/fulfillments
Shows all of the order's fulfillments detailed.
Important information:
Filter | Description |
limit |
Limit size of the search |
page |
Pagination number. |
sinceId |
Filter fullfilments since the Id given |
'createdAt[from]' |
Filter fullfilments by date created from. When used createdAt[to] |
'createdAt[to]' |
Filter fullfilments by date created to. When used createdAt[from] |
'updatedAt[from]' |
Filter fullfilments by date updated from. When used createdAt[to] |
'updatedAt[to]' |
Filter fullfilments by date updated to. When used createdAt[from] |
name |
Filter fullfilments by name |
email |
Filter fullfilments by email |
GET https://api.ecartapi.com/api/v2/orders/{{orderId}}/fulfillments/{{id}}
Shows a selected order fulfillment with detail.
Important information:
POST https://api.ecartapi.com/api/v2/orders/{{orderId}}/fulfillments
Creates an order's fulfillment.
Important information:
PUT https://api.ecartapi.com/api/v2/orders/{{orderId}}/fulfillments/{{id}}
Update the fulfillment information.
Important information:
POST https://api.ecartapi.com/api/v2/orders/{{orderId}}/fulfillments/{{id}}/cancel
Changes an order's fulfillment status to cancelled.
Important information:
GET https://api.ecartapi.com/api/v2/orders/{{orderId}}/locations
This request will provide information for all the posible locations and packages fulfillments that can be made from the different shopify locations available.
The default flag will tell you the store's default shipping location
GET https://api.ecartapi.com/api/v2/orders/{{orderId}}/fulfillments
Shows all of the order's fulfillments detailed.
Important information:
Filter | Description |
limit |
Limit size of the search |
page |
Pagination number. |
sinceId |
Filter fullfilments since the Id given |
'createdAt[from]' |
Filter fullfilments by date created from. When used createdAt[to] |
'createdAt[to]' |
Filter fullfilments by date created to. When used createdAt[from] |
'updatedAt[from]' |
Filter fullfilments by date updated from. When used createdAt[to] |
'updatedAt[to]' |
Filter fullfilments by date updated to. When used createdAt[from] |
name |
Filter fullfilments by name |
email |
Filter fullfilments by email |
GET https://api.ecartapi.com/api/v2/orders/{{orderId}}/fulfillments/{{id}}
Shows a selected order fulfillment with detail.
Important information:
POST https://api.ecartapi.com/api/v2/orders/{{orderId}}/fulfillments
Creates an order's fulfillment.
Important information:
PUT https://api.ecartapi.com/api/v2/orders/{{orderId}}/fulfillments/{{id}}
Update the fulfillment information.
Important information:
POST https://api.ecartapi.com/api/v2/orders/{{orderId}}/fulfillments/{{id}}/cancel
Changes an order's fulfillment status to cancelled.
Important information:
GET https://api.ecartapi.com/api/v2/orders/{{orderId}}/locations
This request will provide information for all the posible locations and packages fulfillments that can be made from the different shopify locations available.
The default flag will tell you the store's default shipping location
GET https://api.ecartapi.com/api/v2/locations
GET https://api.ecartapi.com/api/v2/locations/count
GET https://api.ecartapi.com/api/v2/locations/{{id}}
Searches for the selected location and shows detailed information.
Important information:
GET https://api.ecartapi.com/api/v2/locations/{{locationId}}/inventories
Get all store products available by locationId
GET https://api.ecartapi.com/api/v2/inventories/{{inventoryId}}
Get all store locations available by product.
Important information:
GET https://api.ecartapi.com/api/v2/locations/{{id}}/inventories/{{inventoryId}}
Searches for the selected customer and shows detailed information.
Important information:
PUT https://api.ecartapi.com/api/v2/locations/{{id}}/inventories/{{inventoryId}}
Searches for the selected customer and shows detailed information.
Important information:
GET https://api.ecartapi.com/api/v2/services/carriers
GET https://api.ecartapi.com/api/v1/services/carriers/{{id}}
POST https://api.ecartapi.com/api/v2/services/carriers
PUT https://api.ecartapi.com/api/v2/services/carriers/{{id}}
DELETE https://api.ecartapi.com/api/v2/services/carriers/{{id}}
GET https://api.ecartapi.com/api/v2/services/fulfillment
GET https://api.ecartapi.com/api/v2/services/fulfillment/{{id}}
POST https://api.ecartapi.com/api/v2/services/fulfillment
PUT https://api.ecartapi.com/api/v2/services/fulfillment/{{id}}
DELETE https://api.ecartapi.com/api/v2/services/fulfillment/{{id}}
POST https://api.ecartapi.com/api/v2/services/fulfillment/accepted/{{reference}}
POST https://api.ecartapi.com/api/v2/services/fulfillment/rejected/{{reference}}
GET https://api.ecartapi.com/api/v2/orders/services/fulfillment?status[status]=fulfillment_requested/cancellation_requested
POST https://api.ecartapi.com/api/v2/sevices/payments/activate
POST https://api.ecartapi.com/api/v2/sevices/payments/resolve/success
POST https://api.ecartapi.com/api/v2/sevices/payments/resolve/rejected
POST https://api.ecartapi.com/api/v2/sevices/payments/refund/success
POST https://api.ecartapi.com/api/v2/sevices/payments/refund/rejected
POST https://api.ecartapi.com/api/v2/sevices/payments/authorize/success
POST https://api.ecartapi.com/api/v2/sevices/payments/authorize/rejected
POST https://api.ecartapi.com/api/v2/sevices/payments/void/success
POST https://api.ecartapi.com/api/v2/sevices/payments/void/rejected
GET https://api.ecartapi.com/api/v2/webhooks
With this request you will be able to consult all the webhooks associated to the Amazon Store
GET https://api.ecartapi.com/api/v2/webhooks/{{id}}
Retrieves information of a single webhook from your store
POST https://api.ecartapi.com/api/v2/webhooks
Request to create new webhooks
PUT https://api.ecartapi.com/api/v2/webhooks/{{id}}
DELETE https://api.ecartapi.com/api/v2/webhooks/{{id}}
GET https://api.ecartapi.com/api/v2/orders/{orderId}/fulfillments/{fulfillmentId}/events
city
The city where the fulfillment event occurred.
country
The country where the fulfillment event occurred.
createdAt
The date and time (ISO 8601 format) when the fulfillment event was created.
estimatedDeliveryAt
The estimated delivery date based on the fulfillment's tracking number, as long as it's provided by one of the following carriers: USPS, FedEx, UPS, or Canada Post (Canada only). Value is null
if no tracking number is available or if the tracking number is from an unsupported carrier. This property is available only when carrier calculated rates are in use.'
happenedAt
The date and time (ISO 8601 format) when the fulfillment event occurred.
id
An ID for the fulfillment event.
latitude
A geographic coordinate specifying the latitude of the fulfillment event.
longitude
A geographic coordinate specifying the longitude of the fulfillment event.
description
An arbitrary message describing the status. Can be provided by a shipping carrier.
state
The province where the fulfillment event occurred.
status
The status of the fulfillment event. Valid values:
shipped: 1,
receivedatpostoffice: 2,
intransit: 3,
outfordelivery: 4,
deliveryattemptfailed: 5,
delayed: 6,
pickupready: 7,
delivered: 8,
returnedto_sender: 9,
lost: 10,
failed: 11,
created: 12,
other: 13
updatedAt
The date and time (ISO 8601 format) when the fulfillment event was updated.
postalCode
The zip code of the location where the fulfillment event occurred.
GET https://api.ecartapi.com/api/v2/orders/{orderId}/fulfillments/{fulfillmentId}/events/{id}
POST https://api.ecartapi.com/api/v2/orders/{orderId}/fulfillments/{fulfillmentId}/events
Allowed values for status and meaning:
Ecartapi status | E-commerce status | E-commerce Description |
---|---|---|
pickup_ready | readyforpickup | The shipment is ready for pickup at a shipping depot. |
created | confirmed | The carrier is aware of the shipment, but hasn't received it yet. |
deliveryattemptfailed | attempted_delivery | Delivery of the shipment was attempted, but unable to be completed. |
delivered | delivered | The shipment was successfully delivered. |
failed | failure | Something went wrong when pulling tracking information for the shipment, such as the tracking number was invalid or the shipment was canceled. |
in_transit | in_transit | The shipment is being transported between shipping facilities on the way to its destination. |
outfordelivery | outfordelivery | The shipment is being delivered to its final destination. |
other | picked_up | The fulfillment was successfully picked up. |
DELETE https://api.ecartapi.com/api/v2/orders/{orderId}/fulfillments/{fulfillmentId}/events/{id}
Allowed values for status and meaning:
Ecartapi status | E-commerce status | E-commerce Description |
---|---|---|
pickup_ready | readyforpickup | The shipment is ready for pickup at a shipping depot. |
created | confirmed | The carrier is aware of the shipment, but hasn't received it yet. |
deliveryattemptfailed | attempted_delivery | Delivery of the shipment was attempted, but unable to be completed. |
delivered | delivered | The shipment was successfully delivered. |
failed | failure | Something went wrong when pulling tracking information for the shipment, such as the tracking number was invalid or the shipment was canceled. |
in_transit | in_transit | The shipment is being transported between shipping facilities on the way to its destination. |
outfordelivery | outfordelivery | The shipment is being delivered to its final destination. |
other | picked_up | The fulfillment was successfully picked up. |
GET https://api.ecartapi.com/api/v2/cupons
GET https://api.ecartapi.com/api/v2/cupons/{id}
POST https://api.ecartapi.com/api/v2/cupons
PUT https://api.ecartapi.com/api/v2/cupons/1133821526185
DELETE https://api.ecartapi.com/api/v2/cupons/{id}
GET https://api.ecartapi.com/api/v2/cupons/{cuponsId}/discountCodes
GET https://api.ecartapi.com/api/v2/cupons/{cuponId}/discountCodes/{id}
POST https://api.ecartapi.com/api/v2/cupons/{cuponsId}/discountCodes
PUT https://api.ecartapi.com/api/v2/cupons/{cuponId}/discountCodes/{id}
DELETE https://api.ecartapi.com/api/v2/cupons/{cuponId}/discountCodes/{id}
GET https://api.ecartapi.com/api/v2/metafields?ownerType=order
When using the Get All Metafields resource, you need to specify the ownerType of the Metafield Definition through query parameters, as shown in the example.
GET https://api.ecartapi.com/api/v2/metafields/34854240425
POST https://api.ecartapi.com/api/v2/metafields
Make sure that your integration has the readcontent and writecontent access scopes to be able to create Metafield Definitions.
Properties | Description |
---|---|
name | The human-readable name for the metafield definition. |
namespace | The container for a group of metafields that the metafield definition will be associated with. Must be 3-255 characters long and only contain alphanumeric, hyphen, and underscore characters. |
key | The unique identifier for the metafield definition within its namespace. Must be 3-64 characters long and only contain alphanumeric, hyphen, and underscore characters. |
description | The description for the metafield definition. |
type | The type of data that each of the metafields that belong to the metafield definition will store. Refer to the list of supported types. |
ownerType | The resource type that the metafield definition is attached to. |
PUT https://api.ecartapi.com/api/v2/metafields/34854240425
When you update a Metafield Definition using our Metafield resource, please be aware that you cannot update the type
property.
DELETE https://api.ecartapi.com/api/v2/metafields/33592836265
By using the DELETE Metafield feature, you will be deleting the Metafield Definition in Shopify along with any values that have been recorded in your online store or by API for this metafield.
Once deleted, there is no way to recover the Metafield Definition or the values of its associated Metafields. Make sure you do not depend on your Metafield Definition before using this feature.
GET https://api.ecartapi.com/api/v2/metafields/orders/5501113860265
POST https://api.ecartapi.com/api/v2/metafields/orders/5501113860265
When setting a value for your metafield, keep in mind that you will need to send a JSON string or JSON.
DELETE https://api.ecartapi.com/api/v2/metafields/orders/5501113860265?metafieldId=25455017361577
GET https://api.ecartapi.com/api/v2/metafields/products/7686206488745
POST https://api.ecartapi.com/api/v2/metafields/products/7686206488745
When setting a value for your metafield, keep in mind that you will need to send a JSON string or JSON.
DELETE https://api.ecartapi.com/api/v2/metafields/products/7686206488745?metafieldId=25455224389801
GET https://api.ecartapi.com/api/v2/metafields/products/7686206488745/variants/43809806844073
POST https://api.ecartapi.com/api/v2/metafields/products/7686206488745/variants/43809806844073
When setting a value for your metafield, keep in mind that you will need to send a JSON string or JSON.
DELETE https://api.ecartapi.com/api/v2/metafields/variants/43809806844073?metafieldId=25463052239017
GET https://api.ecartapi.com/api/v2/store
GET https://api.ecartapi.com/api/v2/orders
GET https://api.ecartapi.com/api/v2/orders//{{id}}
PUT https://api.ecartapi.com/api/v2/orders/{{id}}
GET https://api.ecartapi.com/api/v2/customers
GET https://api.ecartapi.com/api/v2/customers//{{id}}
GET https://api.ecartapi.com/api/v2/products
Searches for all products and shows detailed information.
For more information visit the documentation
**Important information:
**
GET https://api.ecartapi.com/api/v2/products/{{id}}
Searches for a selected product and shows the detailed information.
For more information visit thedocumentation
**Important information:
**
POST https://api.ecartapi.com/api/v2/products
Creates a product for shoplazza.
name: Name/Title of the product
subName: SubSubtitle of the product
gtin: Equivalent to barcode
tags: Must Be an array of single words
For more information, visit the documentation
PUT https://api.ecartapi.com/api/v2/products/{{id}}
Updates a product for shoplazza.
name: Name/Title of the product
price: Must be entered with a valid value, even if it won't be changed
For more information visit the documentationdocumentation
**Important information:
**
EndFragment
DELETE https://api.ecartapi.com/api/v2/products/{{id}}
Permanently delete the selected product.
For more information, visit the documentation
**Important information:
**
GET https://api.ecartapi.com/api/v2/products/{{id}}/variants
Searches for all the registered variants of a single product.
For more information, visit the documentation
**Important information:
**
GET https://api.ecartapi.com/api/v2/products/{{productId}}/variants/{{id}}
Searches for the selected variant and shows the detailed information.
For more information, visit the documentation
**Important information:
**
POST https://api.ecartapi.com/api/v2/products/{{id}}/variants
Creates a variation of an available product.
The Product Id Must exist
For more information, visit the documentation
PUT https://api.ecartapi.com/api/v2/products/{{productId}}/variants/{{id}}
Updates a variation of an available product.
For more information, visit the documentation
**Important information:
**
DELETE https://api.ecartapi.com/api/v2/products/{{productId}}/variants/{{id}}
Permanently deletes a product's variation.
For more information, visit the documentation
**Important information:
**
GET https://api.ecartapi.com/api/v2/orders/{{orderId}}/fulfillments
GET https://api.ecartapi.com/api/v2/orders//{{id}}/fulfillment/{{id}}
POST https://api.ecartapi.com/api/v2/orders/{{iorderId}}/fulfillments
GET https://api.ecartapi.com/api/v2/products
This resource can show all products or filters the results with params.
GET https://api.ecartapi.com/api/v2/products/{{id}}
Searches for a selected product and shows the detailed information.
Important information:
POST https://api.ecartapi.com/api/v2/products
Creates a new product and add to the store product list.
* pageId
If you want the product to be published in a certain page get the pageId from the Get Store Request otherwise the product will be published on a random page.
PUT https://api.ecartapi.com/api/v2/products/{{id}}
Updates the product information, according to new detailed information.
Important information:
DELETE https://api.ecartapi.com/api/v2/products/{{id}}
Permanently delete the selected product.
Important information:
GET https://api.ecartapi.com/api/v2/products/{{productId}}/variants
Searches for all the registered variants of a single product.
Important information:
POST https://api.ecartapi.com/api/v2/products/{{productId}}/variants
Creates a variation of an available product.
Important information:
PUT https://api.ecartapi.com/api/v2/products/{{productId}}/variants/{{id}}
Updates a product's variation.
Important information:
DELETE https://api.ecartapi.com/api/v2/products/{{productId}}/variants/{{id}}
Permanently deletes a product's variation.
Important information:
GET https://api.ecartapi.com/api/v2/orders
Retrieves all orders information.
GET https://api.ecartapi.com/api/v2/orders/{{id}}
Searches for a selected order and shows the detailed information.
Important information:
POST https://api.ecartapi.com/api/v2/orders
Creates new orders.
Important information:
POST https://api.ecartapi.com/api/v2/orders/{{orderId}}/fulfillments
GET https://api.ecartapi.comapi/v2/store
Get all store information
GET https://api.ecartapi.com/api/v2/products
GET https://api.ecartapi.com/api/v2/products/{{productId}}
Searches for a selected product and shows the detailed information.
Important information:
POST https://api.ecartapi.com/api/v2/products
PUT https://api.ecartapi.com/api/v2/products/{{productId}}
Updates the product information, according to new detailed information.
Parameters limitations
languages valid values: 'es', 'en' and 'pt'
Important information:
The product's ID must exist
categoryId Must exist.
DELETE https://api.ecartapi.com/api/v2/products/{{productId}}
Permanently delete the selected product.
Important information:
GET https://api.ecartapi.com/api/v2/products/{{productId}}/variants
Searches for all the registered variants of a single product.
Important information:
GET https://api.ecartapi.com/api/v2/products/{{productId}}/variants/{{Id}}
Searches for the selected variant and shows the detailed information.
Important information:
POST https://api.ecartapi.com/api/v2/products/{{productId}}/variants
Creates a variation of an available product.
Important information:
PUT https://api.ecartapi.com/api/v2/products/{{productId}}/variants/{{id}}
Updates the information of an already existing product variant
Important information:
DELETE https://api.ecartapi.com/api/v2/products/{{productId}}/variants/{{id}}
Permanently deletes a product's variation.
Important information:
GET https://api.ecartapi.com/api/v2/products/{{productId}}/images
Searches for all the images of a single product.
Important information:
GET https://api.ecartapi.com/api/v2/products/{{productId}}/images/{{id}}
Searches for all the images of a single product.
Important information:
POST https://api.ecartapi.com/api/v2/products/{{productId}}/images
Adds a new image to an existing product.
Important information:
DELETE https://api.ecartapi.com/api/v2/products/{{productId}}/images/{{id}}
Deletes permanently the selected image of a product.
Important information:
GET https://api.ecartapi.com/api/v2/categories
GET https://api.ecartapi.com/api/v2/categories/{{id}}
Searches for the selected category and shows detailed information.
Important information:
POST https://api.ecartapi.com/api/v2/categories
Creates new category.
PUT https://api.ecartapi.com/api/v2/categories/{{id}}
Update the selected category information.
Important information:
DELETE https://api.ecartapi.com/api/v2/categories/{{id}}
Permanently deletes the selected category.
Important information:
GET https://api.ecartapi.com/api/v2/customers
GET https://api.ecartapi.com/api/v2/customers/{{id}}
Searches for the selected customer and shows detailed information.
Important information:
POST https://api.ecartapi.com/api/v2/customers
Registers a new costumer.
Important information:
PUT https://api.ecartapi.com/api/v2/customers/{{id}}
Update the selected costumer's information.
Important information:
DELETE https://api.ecartapi.com/api/v2/customers/{{id}}
Permanently deletes the selected customer.
Important information:
GET https://api.ecartapi.com/api/v2/orders
GET https://api.ecartapi.com/api/v2/orders/{{id}}
Searches for a selected order and shows the detailed information.
Important information:
POST https://api.ecartapi.com/api/v2/orders
Create an Order.
Value | Description |
---|---|
open | The order is open |
closed | The order is closed |
cancelled | The order is cancelled |
Value | Description |
---|---|
pending | The payment confirmation is pending |
authorized | The payment was authorized but not captured yet |
paid | The payment was successfully confirmed and captured |
voided | The payment confirmation is voided |
refunded | The payment was refunded to the customer |
abandoned | The payment confirmation is abandoned |
PUT https://api.ecartapi.com/api/v2/orders/{{id}}
Update an order's information.
Important information:
DELETE https://api.ecartapi.com/api/v2/orders/{{id}}
Permanently deletes the selected order.
Important information:
GET https://api.ecartapi.com/api/v2/services/carriers
GET https://api.ecartapi.com/api/v1/services/carriers/{{id}}
POST https://api.ecartapi.com/api/v2/services/carriers
GET https://api.ecartapi.com/api/v2/services/carriers/{{carrierId}}/options
GET https://api.ecartapi.com/api/v2/services/carriers/{{carrierId}}/options/{{id}}
POST https://api.ecartapi.com/api/v2/services/carriers/{{carrierId}}/options
PUT https://api.ecartapi.com/api/v2/services/carriers/{{carrierId}}/options/{{id}}
DELETE https://api.ecartapi.com/api/v2/services/carriers/{{carrierId}}/options/{{id}}
PUT https://api.ecartapi.com/api/v1/services/carriers/{{carrierId}}
DELETE https://api.ecartapi.com/api/v1/services/carriers/{{carrierId}}
POST https://api.ecartapi.com/api/v2/orders/{{orderId}}/fulfillments
Creates an order's fulfillment.
Important information:
GET https://api.ecartapi.com/api/v2/orders/{{orderId}}/fulfillments/events
GET https://api.ecartapi.com/api/v2/orders/{{orderId}}/fulfillments/events/{{id}}
POST https://api.ecartapi.com/api/v2/orders/{{orderId}}/fulfillments/events
Possible values for status:
'shipped', 'receivedatpostoffice', 'intransit', 'outfordelivery', 'deliveryattemptfailed', 'delayed', 'pickupready', 'delivered', 'returnedto_sender', 'lost', 'failed'
DELETE https://api.ecartapi.com/api/v2/orders/{{orderId}}/fulfillments/events/{{id}}
Possible values for status:
'shipped', 'receivedatpostoffice', 'intransit', 'outfordelivery', 'deliveryattemptfailed', 'delayed', 'pickupready', 'delivered', 'returnedto_sender', 'lost', 'failed'
GET https://api.ecartapi.com/api/v2/webhooks
GET https://api.ecartapi.com/api/v2/webhooks/:id
POST https://api.ecartapi.com/api/v2/webhooks
PUT https://api.ecartapi.com/api/v2/webhooks/{{id}}
DELETE https://api.ecartapi.com/api/v2/webhooks/:id
GET https://api.ecartapi.com/api/v2/locations
GET https://api.ecartapi.com/api/v2/locations/{{id}}
GET https://api.ecartapi.com/api/v2/store/all
Get authenticated stores
GET https://api.ecartapi.com/api/v2/products
Method get products for retrieves a list of items type products.
GET https://api.ecartapi.com/api/v2/products/1729420161799720033
Get a item of type product using a productId.
ProductId must be exists
DELETE https://api.ecartapi.com/api/v1/products/1729409601337789537
Delete an item type product using a productId.
productId must be exists.
PUT https://api.ecartapi.com/api/v2/products/1729409601337789537
Update a item type product.
The productId must be exist.
For locationId can be get using getProduct resource.
GET https://api.ecartapi.com/api/v2/locations
Use method get locations for retrieves a list of items type location.
POST https://api.ecartapi.com/api/v2/orders/576676899248115480/split
GET https://api.ecartapi.com/api/v2/orders
Get orders retrieves a list of items type orders.
For details of an order use get singe order resource.
GET https://api.ecartapi.com/api/v1/orders/576676899248115480
Get detailed information about an order using orderId.
OrderId must be exist
POST https://api.ecartapi.com/api/v2/orders/576670298683182872/fulfillments/1153051726716047128/cancel
GET https://api.ecartapi.com/api/v2/categories
Retrieves a list of items type categories.
GET https://api.ecartapi.com/api/v1/categories/600001
GET https://api.ecartapi.com/api/v2/services/carriers?ecommerce=true&deliveryType=6956548250505578241
Get all available carriers (providers) for an shipping method.
serviceType is required and can be getted from single order resource in the logistic.serviceId field.
GET https://api.ecartapi.com/api/v2/orders/576670298683182872/fulfillments
Get a list of items type fulfillments of an orden.
orderId is required and must be exists.
GET https://api.ecartapi.com/api/v2/orders/576670298683182872/fulfillments/1153051726716047128
POST https://api.ecartapi.com/api/v2/orders/576675344013758232/fulfillments
PUT https://api.ecartapi.com/api/v2/orders/576670298683182872/fulfillments/1153051726716047128
POST https://api.ecartapi.com/api/v2/webhooks
Create a webhook service for get the notification of an resource
GET https://api.ecartapi.com/api/v2/webhooks
Get a list of webhooks availables in the integration.
DELETE https://api.ecartapi.com/api/v2/webhooks/66606c372629362542f642f3
Delete a webhook service using webhookId
webhookId must be exist.
GET https://api.ecartapi.com/api/v2/inventories/1729423937457589265
GET https://api.ecartapi.com/api/v2/packages?orderId=576679856171224856
Get a list of items type package order.
GET https://api.ecartapi.com/api/v2/packages/1153090621252996888
Get a package using a packageId
packageId must be exist
GET https://api.ecartapi.com/api/v2/customers/699495569
GET https://api.ecartapi.com/api/v2/customers
POST https://api.ecartapi.com/api/v2/customers
PUT https://api.ecartapi.com/api/v2/products/962113246
GET https://api.ecartapi.com/api/v2/products
GET https://api.ecartapi.com/api/v2/products/:id
POST https://api.ecartapi.com/api/v2/products
PUT https://api.ecartapi.com/api/v2/products/:id
GET https://api.ecartapi.com/api/v2/orders
This HTTP GET request retrieves a list of orders from the Tiny e-commerce platform.
By default, 100 records are listed per page.
The response returns a JSON object with a success
key indicating the success status, and an array of orders
containing details about each order.
Each order object includes information such as ID, number, fulfillment status, currency, discounts, totals, dimensions, taxes, status, payment method, customer details, billing and shipping addresses, dates, and other relevant order-related data.
You can find more information about the API resource used in the Tiny Orders API documentation.
GET https://api.ecartapi.com/api/v2/orders/:id
POST https://api.ecartapi.com/api/v2/orders
PUT https://api.ecartapi.com/api/v2/orders/:id
POST https://api.ecartapi.com/api/v2/orders/:orderId/fulfillments
Tiny's resource to synch shipping information is limited to either be via correios or a general transport. By default the shipping option in EcartAPI by making this request WILL ALWAYS BE general transport or in portuguese Transportadora
There are no ID's related to the fulfillment resources so EcartAPI fabricates their own.
All fulfillment ID's will always be 1.
GET https://api.ecartapi.com/api/v2/orders/:orderId/fulfillments
GET https://api.ecartapi.com/api/v2/orders/:orderId/fulfillments/:id
GET https://api.ecartapi.com/api/v2/products
limit |
Limit size of the search |
ids |
Filter items by Id's provided |
'createdAt[from]' |
Filter items by date created from. When used createdAt[to] |
'createdAt[to]' |
Filter items by date created to. When used createdAt[from] |
'updatedAt[from]' |
Filter items by date updated from. When used createdAt[to] |
'updatedAt[to]' |
Filter items by date updated to. When used createdAt[from] |
GET https://api.ecartapi.com/api/v2/products/{{id}}
POST https://api.ecartapi.com/api/v2/products
PUT https://api.ecartapi.com/api/v2/products/{{id}}
DELETE https://api.ecartapi.com/api/v2/products/{{id}}
GET https://api.ecartapi.com/api/v2/products/{{productId}}/variants
GET https://api.ecartapi.com/api/v2/products/{{productId}}/variants/{{id}}
POST https://api.ecartapi.com/api/v2/products/{{productId}}/variants
PUT https://api.ecartapi.com/api/v2/products/{{productId}}/variants/{{id}}
DELETE https://api.ecartapi.com/api/v2/products/{{productId}}/variants/{{id}}
GET https://api.ecartapi.com/api/v2/products/{{productId}}/images
GET https://api.ecartapi.com/api/v2/products/{{productId}}/images/{{id}}
POST https://api.ecartapi.com/api/v2/products/{{productId}}/images
DELETE https://api.ecartapi.com/api/v2/products/{{productId}}/images/{{id}}
GET https://api.ecartapi.com/api/v2/orders
Filter | Description |
ids |
Filter items by Id's provided |
limit |
Limit size of the search |
'createdAt[from]' |
Filter orders by date created from. When used createdAt[to] |
'createdAt[to]' |
Filter orders by date created to. When used createdAt[from] |
'updatedAt[from]' |
Filter orders by date updated from. When used createdAt[to] |
'updatedAt[to]' |
Filter orders by date updated to. When used createdAt[from] |
'status[status]' |
Filter orders by status |
'status[financial]' |
Filter orders by financial status |
'fullfilmentStatus' |
Filter orders by status of fullfilment |
GET https://api.ecartapi.com/api/v2/orders/{{id}}
PUT https://api.ecartapi.com/api/v2/orders/{{id}}
POST https://api.ecartapi.com/api/v2/orders
DELETE https://api.ecartapi.com/api/v2/orders/{{id}}
GET localhost:3000/api/v2/orders/{{orderId}}/fulfillments
Filter | Description |
limit |
Limit size of the search |
'createdAt[from]' |
Filter customers by date created from. When used createdAt[to] |
'createdAt[to]' |
Filter customers by date created to. When used createdAt[from] |
'updatedAt[from]' |
Filter customers by date updated from. When used createdAt[to] |
'updatedAt[to]' |
Filter customers by date updated to. When used createdAt[from] |
GET https://api.ecartapi.com/api/v2/orders/{{orderId}}/fulfillments/{{id}}
POST https://api.ecartapi.com/api/v2/orders/{{orderId}}/fulfillments
PUT https://api.ecartapi.com/api/v2/orders/{{orderId}}/fulfillments/{{id}}
POST https://api.ecartapi.com/api/v2/orders/{{orderId}}/fulfillments/{{id}}/cancel
POST https://api.ecartapi.com/api/v2/refreshtoken
GET https://api.ecartapi.com/api/v2/products
Filter | Description |
limit |
Limit size of the search |
GET https://api.ecartapi.com/api/v2/products/{{id}}
POST https://api.ecartapi.com/api/v2/products
GET https://api.ecartapi.com/api/v2/products/{{productId}}/images
GET https://api.ecartapi.com/api/v2/products/{{productId}}/images/{{id}}
DELETE https://api.ecartapi.com/api/v2/products/{{productId}}/images/{{id}}
GET https://api.ecartapi.com/api/v2/categories
Filter | Description |
limit |
Limit size of the search |
GET https://api.ecartapi.com/api/v2/categories/{{id}}
GET https://api.ecartapi.com/api/v2/orders
Filter | Description |
limit |
Limit size of the search |
GET https://api.ecartapi.com/api/v2/orders/{{id}}
POST https://api.ecartapi.com/api/v2/orders
GET https://api.ecartapi.com/api/v2/customers
GET https://api.ecartapi.com/api/v2/customers/{{id}}
POST https://api.ecartapi.com/api/v2/customers
PUT https://api.ecartapi.com/api/v2/customers/{{id}}
DELETE https://api.ecartapi.com/api/v2/customers/{{id}}
GET https://api.ecartapi.com/api/v2/orders
POST https://api.ecartapi.com/api/v2/orders/{{id}}/cancel
Changes an order's fulfillment status to cancelled.
Important information:
POST https://api.ecartapi.com/api/v2/orders/{{orderId}}/fulfillments
GET https://api.ecartapi.com/api/v2/categories
GET https://api.ecartapi.com/api/v2/categories/{{id}}
GET https://api.ecartapi.com/api/v2/products
Filter | Description |
limit |
Limit size of the search |
page |
Pagination number. |
GET https://api.ecartapi.com/api/v2/products/{{id}}
GET https://api.ecartapi.com/api/v2/orders
Filter | Description |
limit |
Limit size of the search |
page |
Pagination number. |
'status[status]' |
Filter orders by financial status |
GET https://api.ecartapi.com/api/v2/orders/{{id}}
POST https://api.ecartapi.com/api/v2/orders
DELETE https://api.ecartapi.com/api/v2/orders/{{id}}
POST https://api.ecartapi.com/api/v2/orders/{{orderId}}/fulfillments
GET https://api.ecartapi.com/api/v2/payments
GET https://api.ecartapi.com/api/v2/payments/{{id}}
POST https://api.ecartapi.com/api/v2/payments/authorize
GET https://api.ecartapi.com/api/v2/products
GET https://api.ecartapi.com/api/v2/products/{{id}}
PUT https://api.ecartapi.com/api/v2/products/{{id}}
POST https://api.ecartapi.com/api/v2/orders/{{orderId}}/fulfillments
GET https://api.ecartapi.com/api/v2/orders/108735482848338/fulfillments
GET https://api.ecartapi.com/api/v2/orders
Ecommerce limitations.
Only orders created in last 180 days and a maximum of 50000 orders can be fetched at a time. Attempting to download more than 50000 orders will return an error.
GET https://api.ecartapi.com/api/v2/orders/{{id}}
GET https://api.ecartapi.com/api/v2/products
GET https://api.ecartapi.com/api/v2/products/count
GET https://api.ecartapi.com/api/v2/products/{{id}}
POST https://api.ecartapi.com/api/v2/products
PUT https://api.ecartapi.com/api/v2/products/{{id}}
DELETE https://api.ecartapi.com/api/v2/products/{{id}}
GET https://api.ecartapi.com/api/v2/products/{{productId}}/variants
GET https://api.ecartapi.com/api/v2/products/{{productId}}/variants/count
GET https://api.ecartapi.com/api/v2/products/{{productId}}/variants/{{id}}
POST https://api.ecartapi.com/api/v2/products/{{productId}}/variants
PUT https://api.ecartapi.com/api/v2/products/{{productId}}/variants/{{id}}
GET https://api.ecartapi.com/api/v2/products/{{productId}}/images
GET https://api.ecartapi.com/api/v2/products/{{productId}}/images/{{id}}
POST https://api.ecartapi.com/api/v2/products/{{productId}}/images
DELETE https://api.ecartapi.com/api/v2/products/{{productId}}/images/{{id}}
GET https://api.ecartapi.com/api/v2/categories
GET https://api.ecartapi.com/api/v2/categories/count
GET https://api.ecartapi.com/api/v2/categories/{{id}}
POST https://api.ecartapi.com/api/v2/categories
PUT https://api.ecartapi.com/api/v2/categories/{{id}}
DELETE https://api.ecartapi.com/api/v2/categories/{{id}}
GET https://api.ecartapi.com/api/v2/orders
Filter | Description |
limit |
Limit size of the search |
GET https://api.ecartapi.com/api/v2/orders/{{id}}
GET https://api.ecartapi.com/api/v2/orders/{{orderId}}/fulfillments
GET https://api.ecartapi.com/api/v2/orders/{{orderId}}/fulfillments/{{id}}
GET https://api.ecartapi.com/api/v2/orders
Filter | Description |
limit |
Limit size of the search |
page |
Pagination number. |
'status[financial]' |
Filter orders by financial status |
'createdAt[from]' |
Filter orders by date created from. When used createdAt[to] |
'createdAt[to]' |
Filter orders by date created to. When used createdAt[from] |
'status[status]' |
Filter orders by status |
'fullfilmentStatus' |
Filter orders by status of fullfilment |
GET https://api.ecartapi.com/api/v2/orders/{{id}}
GET https://api.ecartapi/api/v2/orders/documents?orderIds=e0a87aab-e3d7-42d2-adad-5cc495ad75dc
GET https://api.ecartapi.com/api/v2/products
Filter | Description |
page | Pagination number. |
limit | Limit size of the search |
name | Filter items by name |
sku | Filter items by sku, Products that have variants cannot be filtered by sku. |
price[min] | Sets the lower threshold of price. |
price[max] | Sets the upper threshold of price. |
createdAt[from] | Filter items by date created from. When used createdAt[to] |
createdAt[to] | Filter items by date created to. When used createdAt[from] |
updatedAt[from] | Filter items by date updated from. When used createdAt[to] |
updatedAt[to] | Filter items by date updated to. When used createdAt[from] |
StartFragment
For more information, check ecommerce documentation
EndFragment
GET https://api.ecartapi.com/api/v2/products/{{id}}
Get information about a single product in the store including its variants
POST https://api.ecartapi.com/api/v2/products
Create a product for wix.
The currency for the price and the weight units, depend of your store configuration on wix.
There are 2 ways to add products to you inventory:
If it’s a product, that has no variants and it’s only the product itself, you can use the “quantity” attribute.
If, however, your products have multiple variants (options to choose), you have to use the request “variant update”.
You can’t use the “quantity” attribute with products with variants, because it will have no effect.
PUT https://api.ecartapi.com/api/v2/products/{{id}}
Updates the product information, according to new detailed information.
**Important information:
DELETE https://api.ecartapi.com/api/v2/products/{{id}}
Permanently delete the selected product.
Important information:
GET https://api.ecartapi.com/api/v2/products/{{productId}}/variants
Searches for all the registered variants of a single product
Important information:
GET https://api.ecartapi.com/api/v2/products/{{productId}}/variants/{{id}}
Searches for the selected variant and shows the detailed information.
Important information:
PUT https://api.ecartapi.com/api/v2/products/{{productId}}/variants/{{id}}
Updates the information of an already existing product variant.
You may experience a delay in response of price and sku attributes
Important information:
POST https://api.ecartapi.com/api/v2/products/{{productId}}/images
Adds a new image to an existing product.
Important information:
DELETE https://api.ecartapi.com/api/v2/products/{{productId}}/images/{{id}}
Deletes permanently the selected image of a product.
Important information:
GET https://api.ecartapi.com/api/v2/orders/{{orderId}}/fulfillments
GET https://api.ecartapi.com/api/v2/orders/{{orderId}}/fulfillments/{{id}}
POST https://api.ecartapi.com/api/v2/orders/{{orderId}}/fulfillments
PUT https://api.ecartapi.com/api/v2/orders/{{orderId}}/fulfillments/{{id}}
POST https://api.ecartapi.com/api/v2/orders/{{orderId}}/fulfillments/{{id}}/cancel
POST https://api.ecartapi.com/api/v2/refreshtoken
GET https://api.ecartapi.com/api/v2/products/214/feedback
GET https://api.ecartapi.com/api/v2/products
Filter | Description |
limit |
Limit size of the search |
page |
Pagination number. |
offet |
Definte the quantity of elements to skip in the next filtering |
'status[status]' |
Filter items by status |
productType |
Filter items by type of product |
name |
Filter items by attribute name |
sku |
Filter items by attribute sku |
'createdAt[from]' |
Filter items by date created from. When used createdAt[to] |
'createdAt[to]' |
Filter items by date created to. When used createdAt[from] |
GET https://api.ecartapi.com/api/v2/products/{{id}}
Searches for a selected product and shows the detailed information.
Important information:
POST https://api.ecartapi.com/api/v2/products
Creates a product for woocommerce.
productType: simple, grouped, external and variable. Default is simple.
status: draft, pending, private and publish. Default is publish.
visibility: visible, catalog, search and hidden. Default is visible.
tags: To create a product with tags you require before create the tag and retrieve the id.
options: To create a new product with options you can create the attribute before in admin panel and retrieve the id like the example of Color option in body (recommended). Too is posible send a option without creates a attribute but this will be only for this product, Size option example.
PUT https://api.ecartapi.com/api/v2/products/447
Creates a product for woocommerce.
productType: simple, grouped, external and variable. Default is simple.
status: draft, pending, private and publish. Default is publish.
visibility: visible, catalog, search and hidden. Default is visible.
tags: To create a product with tags you require before create the tag and retrieve the id.
options: To create a new product with options you can create the attribute before in admin panel and retrieve the id like the example of Color option in body (recommended). Too is posible send a option without creates a attribute but this will be only for this product, Size option example.
DELETE https://api.ecartapi.com/api/v2/products/{{id}}
Permanently delete the selected product.
Important information:
POST https://api.ecartapi.com/api/v2/products/429/variants
GET https://api.ecartapi.com/api/v2/products/{{productId}}/variants
Searches for all the registered variants of a single product.
Important information:
GET https://api.ecartapi.com/api/v2/products/{{productId}}/variants/{{id}}
Searches for the selected variant and shows the detailed information.
Important information:
DELETE https://api.ecartapi.com/api/v2/products/{{productId}}/variants/{{id}}
Permanently deletes a product's variation.
Important information:
POST https://api.ecartapi.com/api/v2/products/{{productId}}/variants/batch
StartFragment
Only the first image will be taken into account the rest of the images in the array will be ignored
EndFragment
GET https://api.ecartapi.com/api/v2/categories
Searches for all the available categories.
Filter | Description |
limit |
Limit size of the search |
name |
Filter categories by name |
GET https://api.ecartapi.com/api/v2/categories/{{id}}
Searches for the selected category and shows detailed information.
Important information:
POST https://api.ecartapi.com/api/v2/categories
Creates a new category.
PUT https://api.ecartapi.com/api/v2/categories/{{id}}
Update the selected category information.
Important information:
DELETE https://api.ecartapi.com/api/v2/categories/{{id}}
Permanently deletes the selected category.
Important information:
GET https://api.ecartapi.com/api/v2/customers
Filter | Description |
limit |
Limit size of the search |
search |
Find customer using a text chain. |
page |
Pagination number. |
offset |
Lower limit of the results block. Modifies the range of the results provided, range goes from offset to limit |
GET https://api.ecartapi.com/api/v2/customers/{{id}}
Searches for the selected customer and shows detailed information.
Important information:
POST https://api.ecartapi.com/api/v2/customers
Registers a new costumer.
Important information:
PUT https://api.ecartapi.com/api/v2/customers/{{id}}
Update the selected costumer's information.
Important information:
DELETE https://api.ecartapi.com/api/v2/customers/{{id}}
Permanently deletes the selected customer.
Important information:
GET https://api.ecartapi.com/api/v2/orders
Filter | Description |
limit |
Limit size of the search |
page |
Pagination number. |
name |
Filter orders by name |
'status[status]' |
Filter orders by status |
offet |
Definte the quantity of elements to skip in the next filtering |
'createdAt[from]' |
Filter orders by date created from. When used createdAt[to] |
'createdAt[to]' |
Filter orders by date created to. When used createdAt[from] |
GET https://api.ecartapi.com/api/v2/orders/{{id}}
Searches for a selected order and shows the detailed information.
Important information:
POST https://api.ecartapi.com/api/v2/orders
Creates new orders.
Important information:
PUT https://api.ecartapi.com/api/v2/orders/{{id}}
Update an order's information.
Important information:
DELETE https://api.ecartapi.com/api/v2/orders/{{id}}
Permanently deletes the selected order.
Important information:
GET https://api.ecartapi.com/api/v2/orders/{{orderId}}/fulfillments
Shows all of the order's fulfillments detailed.
Important information:
GET https://api.ecartapi.com/api/v2/orders/{{orderId}}/fulfillments/{{id}}
Shows a selected order fulfillment with detail.
Important information:
POST https://api.ecartapi.com/api/v2/orders/{{orderId}}/fulfillments
Woocommerce Does not support partial fulfillments this means that you can not send items in this payload or if you send them they wont be taken into account. The order will receive a full fulfillment and all items in the order will be marked as fulfilled.
Creates an order's fulfillment.
Important information:
POST https://api.ecartapi.com/api/v2/orders/{{orderId}}/fulfillments/{{id}}/cancel
Cancels an order's fulfillment.
Important information:
GET https://api.ecartapi.com/api/v2/shippings/zones/{{id}}/locations
PUT https://api.ecartapi.com/api/v2/shippings/zones/{{id}}/locations
GET https://api.ecartapi.com/api/v2/shippings/zones/{{id}}/methods
GET https://api.ecartapi.com/api/v2/shippings/zones/{{zoneId}}/methods/{{id}}
POST https://api.ecartapi.com/api/v2/shippings/zones/{{id}}/methods
PUT https://api.ecartapi.com//api/v2/shippings/zones/{{zoneId}}/methods/{{id}}
DELETE https://api.ecartapi.com/api/v2/shippings/zones/{{zoneId}}/methods/{{id}}
GET https://api.ecartapi.com/api/v2/shippings/zones
GET https://api.ecartapi.com/api/v2/shippings/zones/{{id}}
POST https://api.ecartapi.com/api/v2/shippings/zones
PUT https://api.ecartapi.com/api/v2/shippings/zones/{{id}}
DELETE https://api.ecartapi.com/api/v2/shippings/zones/{{id}}
GET https://api.ecartapi.com/api/v2/shippings
GET https://api.ecartapi.com/api/v2/shippings/{{id}}
OPTIONS https://api.ecartapi.com/api/v2/webhooks
GET https://api.ecartapi.com/api/v2/webhooks
GET https://api.ecartapi.com/api/v2/webhooks/{{id}}
POST https://api.ecartapi.com/api/v2/webhooks
Create Woocommerce webhooks with EcartAPI.
Find listed all the available resources for EcartAPI woocommerce Webhooks.
Resource. | Actions. |
---|---|
customers | create update delete |
products | create update delete |
orders | create update delete |
PUT https://api.ecartapi.com/api/v2/webhooks/{{id}}
DELETE https://api.ecartapi.com/api/v2/webhooks/{{id}}
GET https://api.ecartapi.com/api/v2/cupons?limit=Int&page=Int
GET https://api.ecartapi.com/api/v2/cupons/:id
POST https://api.ecartapi.com/api/v2/cupons
PUT https://api.ecartapi.com/api/v2/cupons/:id
DELETE https://api.ecartapi.com/api/v2/cupons/:id
GET https://api.ecartapi.com/api/v2/orders
GET https://api.ecartapi.com/api/v2/orders/96935553
POST https://api.ecartapi.com/api/v2/orders/96935553/fulfillments
PUT https://api.ecartapi.com/api/v2/orders/96935553/fulfillments/345938
GET https://api.ecartapi.com/api/v2/orders/96935553/fulfillments
GET https://api.ecartapi.com/api/v2/orders/96935553/fulfillments/345938
POST https://api.ecartapi.com/api/v2/orders/96935553/fulfillments/345940/cancel
GET https://api.ecartapi.com/api/v2/products
Retrieve the products available in the store.
GET https://api.ecartapi.com/api/v2/products/:id
Retrieve a product usign a productId
The productId must exist
POST https://api.ecartapi.com/api/v2/products
Create a product for a Yampi store
PUT https://api.ecartapi.com/api/v2/products/19721631
Updates a product information usign the productId
The productId must exist
DELETE https://api.ecartapi.com/api/v2/products/19161096
Delete a product from the store with productId
The productId must exist
GET https://api.ecartapi.com/api/v2/products/19721631/variants
Retrieves all variants of a product.
The productId must exist.
GET https://api.ecartapi.com/api/v2/products/19721631/variants/134288148
Get a single variant of a product.
The productId and variantId must exist.
GET https://api.ecartapi.com/api/v2/webhooks
POST https://api.ecartapi.com/api/v2/webhooks
DELETE https://api.ecartapi.com/api/v2/webhooks/:id
POST https://api.ecartapi.com/api/v2/services/carriers
DELETE https://api.ecartapi.com/api/v2/services/carriers/:id
GET https://api.ecartapi.com/api/v2/categories
Get all catalog categories from a Yampi stores.
GET https://api.ecartapi.com/api/v2/categories/3087993
Retrieve a category usign categoryId.
The categoryId must exists.
POST https://api.ecartapi.com/api/v2/categories
PUT https://api.ecartapi.com/api/v2/categories/3087993
Update a category usign a categoryId.
CategoryId must exist
DELETE https://api.ecartapi.com/api/v2/categories/3087986
Deletes a product category usigin categoryId.
The categoryId must exist.
GET https://api.ecartapi.com/api/v2/customers/152632957
Retrieve the information of all customer from a Yampi store.
GET https://api.ecartapi.com/api/v2/customers
Retrieves the information of a customer
The customerId must exists.
POST https://api.ecartapi.com/api/v2/customers
Creates a customer for a Yampi store.
PUT https://api.ecartapi.com/api/v2/customers/152661001
Updates the information of a customer.
The customerId must exist
DELETE https://api.ecartapi.com/api/v2/customers/152633328
Deletes all customer information usign the customerID.
The customerId must exist.
GET https://api.ecartapi.com/api/v2/products
Filter | Description |
limit |
Limit size of the search |
'status[status]' |
Filter items by status of product: 'active' or 'inactive' |
name |
Filter items by attribute name |
searchType |
Filter items using searchType |
GET https://api.ecartapi.com/api/v2/products/{{id}}
Searches for a selected product and shows the detailed information.
Important information:
POST https://api.ecartapi.com/api/v2/products
Create a product and shows the detailed information.
To create a new product name is required.
PUT https://api.ecartapi.com/api/v2/products/{{id}}
Updates the product information, according to new detailed information.
Important information:
DELETE https://api.ecartapi.com/api/v2/products/{{id}}
Important information:
GET https://api.ecartapi.com/api/v2/customers
Filter | Description |
search |
Find customer using a text chain. |
name |
Filter customers by name |
email |
Filter customers by email |
GET https://api.ecartapi.com/api/v2/customers/{{id}}
Searches for a selected customer and shows the detailed information.
Important information:
POST https://api.ecartapi.com/api/v2/customers
PUT https://api.ecartapi.com/api/v2/customers/{{id}}
Updates the customer information.
Important information:
DELETE https://api.ecartapi.com/api/v2/customers/{{id}}
Delete a selected customer .
Important information:
GET https://api.ecartapi.com/api/v2/orders
Filter | Description |
limit |
Limit size of the search |
search |
Filter orders by a text chain |
'status[status]' |
Filter orders by status |
GET https://api.ecartapi.com/api/v2/orders/{{id}}
Searches for a selected order and shows the detailed information.
Important information:
POST https://api.ecartapi.com/api/v2/orders
Create a order and shows the detailed information.
To create a order the customer's ID is required.
You can get the customer Id from the customer requests.
PUT https://api.ecartapi.com/api/v2/orders/{{id}}
DELETE https://api.ecartapi.com/api/v2/orders/{{id}}
GET https://api.ecartapi.com/api/v2/orders/{{orderId}}/fulfillments
GET https://api.ecartapi.com/api/v2/orders/{{orderId}}/fulfillments/{{id}}
POST https://api.ecartapi.com/api/v2/orders/{{orderId}}/fulfillments
"shippingDate"
- Date (YYYY-MM-DD). date value must happen after order was created
POST localhost:3000/api/v1/orders/{{orderId}}/fulfillments/{{id}}/cancel
GET https://api.ecartapi.com/api/v2/packages
GET https://api.ecartapi.com/api/v2/packages/{{id}}
POST https://api.ecartapi.com/api/v2/packages/{{orderId}}
PUT https://api.ecartapi.com/api/v2/packages/{{id}}
DELETE https://api.ecartapi.com/api/v2/packages/{{id}}
POST localhost:3000/api/v2/refreshtoken
ENDPOINTS