VTEX - Price Simulations.json

{
    "openapi": "3.0.0",
    "info": {
        "title": "Price Simulations API",
        "description": "",
        "contact": {},
        "version": "1.0"
    },
    "servers": [
        {
            "url": "https://{accountName}.{environment}.com.br",
            "description": "VTEX server url"
        }
    ],
    "paths": {
        "/_v/custom-prices/session/schema": {
            "get": {
                "summary": "Get custom prices schema",
                "tags": [
                    "Custom Prices"
                ],
                "description": "Retrieves all custom price for all shopping scenarios",
                "parameters": [
                    {
                        "name": "accountName",
                        "in": "path",
                        "required": true,
                        "description": "Name of the VTEX account. Used as part of the URL",
                        "schema": {
                            "type": "string",
                            "default": "apiexamples"
                        }
                    },
                    {
                        "name": "environment",
                        "in": "path",
                        "required": true,
                        "description": "Environment to use. Used as part of the URL",
                        "schema": {
                            "type": "string",
                            "default": "vtexcommercestable"
                        }
                    },
                    {
                        "name": "Content-Type",
                        "in": "header",
                        "description": "Describes the type of the content being sent",
                        "required": true,
                        "style": "simple",
                        "schema": {
                            "type": "string",
                            "default": "application/json"
                        }
                    },
                    {
                        "name": "Accept",
                        "in": "header",
                        "description": "HTTP Client Negotiation _Accept_ Header. Indicates the types of responses the client can understand",
                        "required": true,
                        "style": "simple",
                        "schema": {
                            "type": "string",
                            "default": "application/json"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema":{
                                    "type": "object",
                                    "title": "Request body",
                                    "default": {
                                        "fields": [
                                            {
                                                "name": "orderType",
                                                "type": "string"
                                            },
                                            {
                                                "name": "state",
                                                "type": "string"
                                            }
                                        ],
                                        "useEmail": true
                                     },
                                    
                                    "required": [
                                        "fields"
                                    ],
                                    "properties": {
                                        "fields": {
                                            "type": "array",
                                            "title": "fields",
                                            "description": "Order Configuration criteria",
                                            "default": [
                                                {
                                                    "name": "orderType",
                                                    "type": "string"
                                                },
                                                {
                                                    "name": "state",
                                                    "type": "string"
                                                }
                                            ],
                                            "items": { 
                                                "type": "object",
                                                "default": {
                                                    "name": "orderType",
                                                        "type": "string"
                                                },
                                                "required": [
                                                    "name",
                                                    "type"
                                                ],
                                                "properties": {
                                                    "name": {
                                                        "type": "string",
                                                        "title": "name",
                                                        "description": "Criteria name",
                                                        "default": "orderType"
                                                    },
                                                    "type": {
                                                        "type": "string",
                                                        "title": "type",
                                                        "description": "Criteria type",
                                                        "default": "string"
                                                    }
                                                }
                                            }
                                        },
                                        "useEmail": {
                                            "type": "boolean",
                                            "title": "useEmail",
                                            "description": "If the custom price should use the user's e-mail to validate it",
                                            "default": true                                            
                                        }
                                    }
                                }
                            }
                        }
                    }
                }
            },
            "post": {
                "summary": "Create or Update custom prices schema",
                "tags": [
                    "Custom Prices"
                ],
                "description": "Creates a new custom price for a shopping scenario or updates an existing one",
                "parameters": [
                    {
                        "name": "accountName",
                        "in": "path",
                        "required": true,
                        "description": "Name of the VTEX account. Used as part of the URL",
                        "schema": {
                            "type": "string",
                            "default": "apiexamples"
                        }
                    },
                    {
                        "name": "environment",
                        "in": "path",
                        "required": true,
                        "description": "Environment to use. Used as part of the URL",
                        "schema": {
                            "type": "string",
                            "default": "vtexcommercestable"
                        }
                    },
                    {
                        "name": "Content-Type",
                        "in": "header",
                        "description": "Describes the type of the content being sent",
                        "required": true,
                        "style": "simple",
                        "schema": {
                            "type": "string",
                            "default": "application/json"
                        }
                    },
                    {
                        "name": "Accept",
                        "in": "header",
                        "description": "HTTP Client Negotiation _Accept_ Header. Indicates the types of responses the client can understand",
                        "required": true,
                        "style": "simple",
                        "schema": {
                            "type": "string",
                            "default": "application/json"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema":{
                                    "type": "object",
                                    "title": "Request body",
                                    "default": {
                                        "fields": [
                                            {
                                                "name": "orderType",
                                                "type": "string"
                                            },
                                            {
                                                "name": "state",
                                                "type": "string"
                                            }
                                        ],
                                        "useEmail": true
                                     },
                                    
                                    "required": [
                                        "fields"
                                    ],
                                    "properties": {
                                        "fields": {
                                            "type": "array",
                                            "title": "fields",
                                            "description": "Order Configuration criteria",
                                            "default": [
                                                {
                                                    "name": "orderType",
                                                    "type": "string"
                                                },
                                                {
                                                    "name": "state",
                                                    "type": "string"
                                                }
                                            ],
                                            "items": { 
                                                "type": "object",
                                                "default": {
                                                    "name": "orderType",
                                                        "type": "string"
                                                },
                                                "required": [
                                                    "name",
                                                    "type"
                                                ],
                                                "properties": {
                                                    "name": {
                                                        "type": "string",
                                                        "title": "name",
                                                        "description": "Criteria name",
                                                        "default": "orderType"
                                                    },
                                                    "type": {
                                                        "type": "string",
                                                        "title": "type",
                                                        "description": "Criteria type",
                                                        "default": "string"
                                                    }
                                                }
                                            }
                                        },
                                        "useEmail": {
                                            "type": "boolean",
                                            "title": "useEmail",
                                            "description": "If the custom price should use the user's e-mail to validate it",
                                            "default": true                                            
                                        }
                                    }
                                }
                            }
                        }
                    }
                },
                "requestBody": {
                    "description": "",
                    "content": {
                        "application/json": {
                            "schema":{
                                "type": "object",
                                "title": "Request body",
                                "default": {
                                    "fields": [
                                        {
                                            "name": "orderType",
                                            "type": "string"
                                        },
                                        {
                                            "name": "state",
                                            "type": "string"
                                        }
                                    ],
                                    "useEmail": true
                                 },
                                
                                "required": [
                                    "fields"
                                ],
                                "properties": {
                                    "fields": {
                                        "type": "array",
                                        "title": "fields",
                                        "description": "Order Configuration criteria",
                                        "default": [
                                            {
                                                "name": "orderType",
                                                "type": "string"
                                            },
                                            {
                                                "name": "state",
                                                "type": "string"
                                            }
                                        ],
                                        "items": { 
                                            "type": "object",
                                            "default": {
                                                "name": "orderType",
                                                    "type": "string"
                                            },
                                            "required": [
                                                "name",
                                                "type"
                                            ],
                                            "properties": {
                                                "name": {
                                                    "type": "string",
                                                    "title": "name",
                                                    "description": "Criteria name",
                                                    "default": "orderType"
                                                },
                                                "type": {
                                                    "type": "string",
                                                    "title": "type",
                                                    "description": "Criteria type",
                                                    "default": "string"
                                                }
                                            }
                                        }
                                    },
                                    "useEmail": {
                                        "type": "boolean",
                                        "title": "useEmail",
                                        "description": "If the custom price should use the user's e-mail to validate it",
                                        "default": true                                            
                                    }
                                }
                            }
                        }
                    }
                }
            }
        },
        "/sessions/": {
            "post": {
                "summary": "Update Order Configuration",
                "tags": [
                    "Session Management"
                ],
                "description": "Updates the Order Configuration. You should use this route every time you edit a configuration value",
                "parameters": [
                    {
                        "name": "accountName",
                        "in": "path",
                        "required": true,
                        "description": "Name of the VTEX account. Used as part of the URL",
                        "schema": {
                            "type": "string",
                            "default": "apiexamples"
                        }
                    },
                    {
                        "name": "environment",
                        "in": "path",
                        "required": true,
                        "description": "Environment to use. Used as part of the URL",
                        "schema": {
                            "type": "string",
                            "default": "vtexcommercestable"
                        }
                    },
                    {
                        "name": "Content-Type",
                        "in": "header",
                        "description": "Describes the type of the content being sent",
                        "required": true,
                        "style": "simple",
                        "schema": {
                            "type": "string",
                            "default": "application/json"
                        }
                    },
                    {
                        "name": "Accept",
                        "in": "header",
                        "description": "HTTP Client Negotiation _Accept_ Header. Indicates the types of responses the client can understand",
                        "required": true,
                        "style": "simple",
                        "schema": {
                            "type": "string",
                            "default": "application/json"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                }
                            }
                        }
                    }
                },
                "requestBody": {
                    "description": "",
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "title": "Request Body",
                                "description": "",
                                "default": {},
                                "required": [
                                    "public"
                                ],
                                "properties": {
                                    "public": {
                                        "type": "object",
                                        "title": "public",
                                        "description": "Object to register session criteria",
                                        "default": {},
                                        "required": [
                                            "customSessionKeys"
                                        ],
                                        "properties": {
                                            "customSessionKeys": {
                                                "type": "object",
                                                "title": "customSessionKeys",
                                                "description": "Contains every schema criteria. This is a serialized JSON object",
                                                "default": {"value": "{\"state\":\"ES\",\"orderType\":\"res\"}"},
                                                "required": [
                                                    "value"
                                                ],
                                                "properties": {
                                                    "value": {
                                                        "type": "string",
                                                        "title": "value",
                                                        "description": "Order Configuration criteria",
                                                        "default": ""
                                                    }
                                                }
                                            }
                                        }
                                    }
                                }
                            }
                        }
                    }
                }
            }
        },
        "/_v/custom-prices/rules/{priceAssociationId}": {
            "get": {
                "summary": "Get price association by ID",
                "tags": [
                    "Price Association"
                ],
                "description": "Retrieves price association for a shopping scenario by its ID",
                "parameters": [
                    {
                        "name": "accountName",
                        "in": "path",
                        "required": true,
                        "description": "Name of the VTEX account. Used as part of the URL",
                        "schema": {
                            "type": "string",
                            "default": "apiexamples"
                        }
                    },
                    {
                        "name": "environment",
                        "in": "path",
                        "required": true,
                        "description": "Environment to use. Used as part of the URL",
                        "schema": {
                            "type": "string",
                            "default": "vtexcommercestable"
                        }
                    },
                    {
                        "name": "Content-Type",
                        "in": "header",
                        "description": "Describes the type of the content being sent",
                        "required": true,
                        "style": "simple",
                        "schema": {
                            "type": "string",
                            "default": "application/json"
                        }
                    },
                    {
                        "name": "Accept",
                        "in": "header",
                        "description": "HTTP Client Negotiation _Accept_ Header. Indicates the types of responses the client can understand",
                        "required": true,
                        "style": "simple",
                        "schema": {
                            "type": "string",
                            "default": "application/json"
                        }
                    },
                    {
                        "name": "priceAssociationId",
                        "in": "path",
                        "required": true,
                        "description": "Price Association unique identifier",
                        "schema": {
                            "type": "integer",
                            "default": 1
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "default": {},
                                    "required": [
                                        "id",
                                        "pricetable"
                                    ],
                                    "properties": {
                                        "id":{
                                            "type": "integer",
                                            "title": "id",
                                            "description": "Price association ID",
                                            "default": ""
                                        },
                                        "orderType": {
                                            "type": "string",
                                            "title": "orderType",
                                            "description": "Order type",
                                            "default": ""
                                        },
                                        "state": {
                                            "type": "string",
                                            "title": "state",
                                            "description": "Delivery location",
                                            "default": ""
                                        },
                                        "pricetable": {
                                            "type": "string",
                                            "title": "pricetable",
                                            "description": "Name of the Price Table associated with the scenario",
                                            "default": ""
                                        },
                                        "email": {
                                            "title": "email",
                                            "description": "User's email",
                                            "default": ""
                                        }
                                    }
                                }
                            }
                        }
                    }
                }
            },
            "put": {
                "summary": "Update price association by ID",
                "tags": [
                    "Price Association"
                ],
                "description": "Updates a price association for a shopping scenario by its ID",
                "parameters": [
                    {
                        "name": "accountName",
                        "in": "path",
                        "required": true,
                        "description": "Name of the VTEX account. Used as part of the URL",
                        "schema": {
                            "type": "string",
                            "default": "apiexamples"
                        }
                    },
                    {
                        "name": "environment",
                        "in": "path",
                        "required": true,
                        "description": "Environment to use. Used as part of the URL",
                        "schema": {
                            "type": "string",
                            "default": "vtexcommercestable"
                        }
                    },
                    {
                        "name": "Content-Type",
                        "in": "header",
                        "description": "Describes the type of the content being sent",
                        "required": true,
                        "style": "simple",
                        "schema": {
                            "type": "string",
                            "default": "application/json"
                        }
                    },
                    {
                        "name": "Accept",
                        "in": "header",
                        "description": "HTTP Client Negotiation _Accept_ Header. Indicates the types of responses the client can understand",
                        "required": true,
                        "style": "simple",
                        "schema": {
                            "type": "string",
                            "default": "application/json"
                        }
                    },
                    {
                        "name": "priceAssociationId",
                        "in": "path",
                        "required": true,
                        "description": "Price Association unique identifier",
                        "schema": {
                            "type": "integer",
                            "default": 1
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "default": {},
                                    "required": [
                                        "id",
                                        "pricetable"
                                    ],
                                    "properties": {
                                        "id":{
                                            "type": "integer",
                                            "title": "id",
                                            "description": "Price association ID",
                                            "default": ""
                                        },
                                        "orderType": {
                                            "type": "string",
                                            "title": "orderType",
                                            "description": "Order type",
                                            "default": ""
                                        },
                                        "state": {
                                            "type": "string",
                                            "title": "state",
                                            "description": "Delivery location",
                                            "default": ""
                                        },
                                        "pricetable": {
                                            "type": "string",
                                            "title": "pricetable",
                                            "description": "Name of the Price Table associated with the scenario",
                                            "default": ""
                                        },
                                        "email": {
                                            "title": "email",
                                            "description": "User's email",
                                            "default": ""
                                        }
                                    }
                                }
                            }
                        }
                    }
                },
                "requestBody": {
                    "description": "",
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "title": "Request body",
                                "default": {},
                                "required": [
                                    "orderType",
                                    "state",
                                    "pricetable"
                                ],
                                "properties": {
                                    "orderType": {
                                        "type": "string",
                                        "title": "orderType",
                                        "description": "Order type",
                                        "default": "orderType"
                                    },
                                    "state": {
                                        "type": "string",
                                        "title": "state",
                                        "description": "Delivery location",
                                        "default": "RR"
                                    },
                                    "pricetable": {
                                        "type": "string",
                                        "title": "pricetable",
                                        "description": "Name of the Price Table associated with the scenario",
                                        "default": "pricetable1"
                                    }
                                }
                            }
                        }
                    }
                }
            },
            "delete": {
                "summary": "Disassociate price association by ID",
                "tags": [
                    "Price Association"
                ],
                "description": "Disassociates a price association from a shopping scenario by its ID",
                "parameters": [
                    {
                        "name": "accountName",
                        "in": "path",
                        "required": true,
                        "description": "Name of the VTEX account. Used as part of the URL",
                        "schema": {
                            "type": "string",
                            "default": "apiexamples"
                        }
                    },
                    {
                        "name": "environment",
                        "in": "path",
                        "required": true,
                        "description": "Environment to use. Used as part of the URL",
                        "schema": {
                            "type": "string",
                            "default": "vtexcommercestable"
                        }
                    },
                    {
                        "name": "Content-Type",
                        "in": "header",
                        "description": "Describes the type of the content being sent",
                        "required": true,
                        "style": "simple",
                        "schema": {
                            "type": "string",
                            "default": "application/json"
                        }
                    },
                    {
                        "name": "Accept",
                        "in": "header",
                        "description": "HTTP Client Negotiation _Accept_ Header. Indicates the types of responses the client can understand",
                        "required": true,
                        "style": "simple",
                        "schema": {
                            "type": "string",
                            "default": "application/json"
                        }
                    },
                    {
                        "name": "priceAssociationId",
                        "in": "path",
                        "required": true,
                        "description": "Price Association unique identifier",
                        "schema": {
                            "type": "integer",
                            "default": 1
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "string",
                                    "default": "Rule deleted with success: custom_prices-5dc4f3d6-dda6-11ea-835b-12d97a7637bf"
                                }
                            }
                        }
                    }
                }
            }
        },
        "/_v/custom-prices/rules": {
            "post": {
                "summary": "Create price association",
                "tags": [
                    "Price Association"
                ],
                "description": "Creates a new price association for a shopping scenario",
                "parameters": [
                    {
                        "name": "accountName",
                        "in": "path",
                        "required": true,
                        "description": "Name of the VTEX account. Used as part of the URL",
                        "schema": {
                            "type": "string",
                            "default": "apiexamples"
                        }
                    },
                    {
                        "name": "environment",
                        "in": "path",
                        "required": true,
                        "description": "Environment to use. Used as part of the URL",
                        "schema": {
                            "type": "string",
                            "default": "vtexcommercestable"
                        }
                    },
                    {
                        "name": "Content-Type",
                        "in": "header",
                        "description": "Describes the type of the content being sent",
                        "required": true,
                        "style": "simple",
                        "schema": {
                            "type": "string",
                            "default": "application/json"
                        }
                    },
                    {
                        "name": "Accept",
                        "in": "header",
                        "description": "HTTP Client Negotiation _Accept_ Header. Indicates the types of responses the client can understand",
                        "required": true,
                        "style": "simple",
                        "schema": {
                            "type": "string",
                            "default": "application/json"
                        }
                    }
                ],
                "responses": {
                    "200": {
                        "description": "OK",
                        "content": {
                            "application/json": {
                                "schema": {
                                    "type": "object",
                                    "default": {},
                                    "required": [
                                        "id",
                                        "pricetable"
                                    ],
                                    "properties": {
                                        "id":{
                                            "type": "integer",
                                            "title": "id",
                                            "description": "Price association ID",
                                            "default": ""
                                        },
                                        "orderType": {
                                            "type": "string",
                                            "title": "orderType",
                                            "description": "Order type",
                                            "default": ""
                                        },
                                        "state": {
                                            "type": "string",
                                            "title": "state",
                                            "description": "Delivery location",
                                            "default": ""
                                        },
                                        "pricetable": {
                                            "type": "string",
                                            "title": "pricetable",
                                            "description": "Name of the Price Table associated with the scenario",
                                            "default": ""
                                        },
                                        "email": {
                                            "title": "email",
                                            "description": "User's email",
                                            "default": ""
                                        }
                                    }
                                }
                            }
                        }
                    }
                },
                "requestBody": {
                    "description": "",
                    "content": {
                        "application/json": {
                            "schema": {
                                "type": "object",
                                "default": {},
                                "required": [
                                    "pricetable"
                                ],
                                "properties": {
                                    "orderType": {
                                        "type": "string",
                                        "title": "orderType",
                                        "description": "Order type",
                                        "default": ""
                                    },
                                    "state": {
                                        "type": "string",
                                        "title": "state",
                                        "description": "Delivery location",
                                        "default": ""
                                    },
                                    "pricetable": {
                                        "type": "string",
                                        "title": "pricetable",
                                        "description": "Name of the Price Table associated with the scenario",
                                        "default": ""
                                    },
                                    "email": {
                                        "title": "email",
                                        "description": "User's email",
                                        "default": ""
                                    }
                                }
                            }
                        }
                    }
                }
            }
        }
    },
    "tags": [
        {
            "name": "Session Management"
        },
        {
            "name": "Custom Prices"
        },
        {
            "name": "Price Association"
        }
        
    ]
}