Venddor API v1.0 Documentation

Backward-compatible REST API for seamless migration. Drop-in replacement for existing legacy API consumers.

212
Endpoints
74
Entities
10
Categories
Base URL
https://your-store.venddor.com.br/api/v1.0/
Authentication
HTTP Basic Auth — email:api_key
Or use POST /auth_tokens for token-based auth

Getting Started

The v1.0 API provides full backward compatibility. If you have existing integrations with the legacy REST API, simply change the base URL to your Venddor store and everything works out of the box.

Authentication

All endpoints (except /auth_tokens) require HTTP Basic Auth. Use your admin email as username and your API key as password.

bash
curl -u admin@venddor.com.br:YOUR_API_KEY \
  "https://your-store.venddor.com.br/api/v1.0/products"

Token Authentication

Alternatively, obtain a token via POST /auth_tokens and use it in the Authorization header.

bash
# Get token
curl -X POST \
  -H "Content-Type: application/json" \
  -d '{"email":"admin@venddor.com.br","password":"***"}' \
  "https://your-store.venddor.com.br/api/v1.0/auth_tokens"

# Use token
curl -H "Authorization: Bearer TOKEN" \
  "https://your-store.venddor.com.br/api/v1.0/products"

Response Format

All responses are JSON. List endpoints return paginated results with a paramsobject. Monetary values are returned as decimal strings (e.g. "49.90"). IDs are returned as strings.

Status Codes

200Success
201Created
400Bad Request
401Unauthorized
403Forbidden
404Not Found
422Validation Error
500Server Error

Core

5 entities

AuthTokens

Authenticate via email/password or CNPJ/password to receive a session token. This is the only unauthenticated endpoint.

POST/api/v1.0/auth_tokens

Request Body Fields

FieldType
emailstring
passwordstring
CNPJstring

Response Example

json
{
  "token": "eyJhbGciOiJIUzI1NiIs...",
  "ttl": 86400
}

Products

Full product CRUD with legacy field compatibility. Prices as decimal strings, amounts as integers.

GET/api/v1.0/products
GET/api/v1.0/products/{id}
POST/api/v1.0/products
PUT/api/v1.0/products/{id}
DELETE/api/v1.0/products/{id}
GET/api/v1.0/products/{product_id}/discussions
GET/api/v1.0/products/{product_id}/features

Query Parameters

NameType
pageinteger
items_per_pageinteger
company_idinteger
category_idinteger
statusstring
qstring
product_codestring
sort_bystring
sort_orderstring

Request Body Fields

FieldType
productstring
product_codestring
pricestring
amountinteger
company_idinteger
category_idsinteger[]
statusstring
full_descriptionstring
short_descriptionstring
main_pairobject
weightstring
list_pricestring

Response Example

json
{
  "products": [
    {
      "product_id": "123",
      "product": "Cimento Portland CP-II 50kg",
      "product_code": "CIM-CP2-50",
      "price": "49.90",
      "list_price": "59.90",
      "amount": "150",
      "status": "A",
      "company_id": "5",
      "category_ids": [12, 34],
      "main_pair": {
        "detailed": {
          "image_path": "https://cdn.venddor.com.br/images/123.jpg"
        }
      },
      "timestamp": "1711929600"
    }
  ],
  "params": {
    "total_items": 342,
    "page": 1,
    "items_per_page": 10
  }
}

Orders

Order management with full lifecycle support. Status codes follow legacy conventions.

GET/api/v1.0/orders
GET/api/v1.0/orders/{id}
POST/api/v1.0/orders
PUT/api/v1.0/orders/{id}
DELETE/api/v1.0/orders/{id}

Query Parameters

NameType
pageinteger
items_per_pageinteger
statusstring
user_idinteger
company_idinteger
periodstring
time_frominteger
time_tointeger

Request Body Fields

FieldType
user_idinteger
statusstring
productsobject[]
payment_idinteger
shipping_idinteger
user_dataobject

Response Example

json
{
  "orders": [
    {
      "order_id": "1042",
      "user_id": "87",
      "total": "249.80",
      "subtotal": "199.80",
      "shipping_cost": "50.00",
      "status": "P",
      "timestamp": "1711929600",
      "company_id": "5",
      "products": {
        "1": {
          "product_id": "123",
          "product": "Cimento Portland",
          "amount": "2",
          "price": "99.90"
        }
      }
    }
  ],
  "params": { "total_items": 156, "page": 1 }
}

Users

User management for customers, vendors, and admins. Supports Brazilian-specific fields (CPF/CNPJ).

GET/api/v1.0/users
GET/api/v1.0/users/{id}
POST/api/v1.0/users
PUT/api/v1.0/users/{id}
DELETE/api/v1.0/users/{id}
GET/api/v1.0/users/{user_id}/usergroups
PUT/api/v1.0/users/{user_id}/usergroups/{group_id}

Query Parameters

NameType
pageinteger
items_per_pageinteger
user_typestring
statusstring
company_idinteger
qstring

Request Body Fields

FieldType
emailstring
passwordstring
user_typestring
statusstring
firstnamestring
lastnamestring
phonestring
company_idinteger
CNPJstring

Response Example

json
{
  "users": [
    {
      "user_id": "87",
      "email": "joao@empresa.com.br",
      "user_type": "C",
      "status": "A",
      "firstname": "Joao",
      "lastname": "Silva",
      "phone": "+5511999887766",
      "company_id": "0"
    }
  ],
  "params": { "total_items": 1245, "page": 1 }
}

Categories

Product category hierarchy with full CRUD. Nested categories supported via parent_id.

GET/api/v1.0/categories
GET/api/v1.0/categories/{id}
POST/api/v1.0/categories
PUT/api/v1.0/categories/{id}
DELETE/api/v1.0/categories/{id}
GET/api/v1.0/categories/{id}/products

Request Body Fields

FieldType
categorystring
parent_idinteger
statusstring
positioninteger

Response Example

json
{
  "categories": [
    {
      "category_id": "12",
      "category": "Materiais de Construcao",
      "parent_id": "0",
      "status": "A",
      "position": "10",
      "product_count": "87"
    }
  ]
}

Catalog

4 entities

Features

Product features/attributes (color, size, brand, etc). Supports text, number, date, select, and checkbox types.

GET/api/v1.0/features
GET/api/v1.0/features/{id}
POST/api/v1.0/features
PUT/api/v1.0/features/{id}
DELETE/api/v1.0/features/{id}

Request Body Fields

FieldType
descriptionstring
feature_typestring
categories_idsinteger[]
group_idinteger

Options

Product options (size, color selectors, text inputs). Options drive variant combinations.

GET/api/v1.0/options
GET/api/v1.0/options/{id}
POST/api/v1.0/options
PUT/api/v1.0/options/{id}
DELETE/api/v1.0/options/{id}

Request Body Fields

FieldType
option_namestring
option_typestring
product_idinteger
variantsobject[]

Combinations

Option combinations (variants) with their own price, SKU, stock, weight, and image.

GET/api/v1.0/combinations
GET/api/v1.0/combinations/{hash}
POST/api/v1.0/combinations
PUT/api/v1.0/combinations/{hash}
DELETE/api/v1.0/combinations/{hash}

Request Body Fields

FieldType
product_idinteger
combinationobject
amountinteger
pricestring
product_codestring

Exceptions

Option combination exceptions (forbidden or allowed combinations).

GET/api/v1.0/exceptions
GET/api/v1.0/exceptions/{id}
POST/api/v1.0/exceptions
DELETE/api/v1.0/exceptions/{id}

Request Body Fields

FieldType
product_idinteger
combinationobject
typestring

Commerce

5 entities

Payments

Payment method configuration and management.

GET/api/v1.0/payments
GET/api/v1.0/payments/{id}
POST/api/v1.0/payments
PUT/api/v1.0/payments/{id}
DELETE/api/v1.0/payments/{id}

Request Body Fields

FieldType
paymentstring
processor_typestring
processor_paramsobject
positioninteger
company_idstring
descriptionstring
statusstring

Shippings

Shipping method configuration and management.

GET/api/v1.0/shippings
GET/api/v1.0/shippings/{id}
POST/api/v1.0/shippings
PUT/api/v1.0/shippings/{id}
DELETE/api/v1.0/shippings/{id}

Shipments

Shipment tracking for orders (tracking numbers, carrier info).

GET/api/v1.0/shipments
GET/api/v1.0/shipments/{id}
POST/api/v1.0/shipments
PUT/api/v1.0/shipments/{id}
DELETE/api/v1.0/shipments/{id}

Request Body Fields

FieldType
order_idstring
shipping_idstring
tracking_numberstring
carrierstring
commentsstring
productsarray

Statuses

Order status definitions and configuration.

GET/api/v1.0/statuses
GET/api/v1.0/statuses/{id}
POST/api/v1.0/statuses
PUT/api/v1.0/statuses/{id}
DELETE/api/v1.0/statuses/{id}

Taxes

Tax rule management (ICMS, ISS, IPI for Brazilian market).

GET/api/v1.0/taxes
GET/api/v1.0/taxes/{id}
POST/api/v1.0/taxes
PUT/api/v1.0/taxes/{id}
DELETE/api/v1.0/taxes/{id}

Content

6 entities

Pages

CMS pages (about, terms, blog posts, etc).

GET/api/v1.0/pages
GET/api/v1.0/pages/{id}
POST/api/v1.0/pages
PUT/api/v1.0/pages/{id}
DELETE/api/v1.0/pages/{id}

Request Body Fields

FieldType
pagestring
page_typestring
descriptionstring
statusstring

Blocks

Layout blocks for storefront page composition.

GET/api/v1.0/blocks
GET/api/v1.0/blocks/{id}
POST/api/v1.0/blocks
PUT/api/v1.0/blocks/{id}
DELETE/api/v1.0/blocks/{id}

Languages

Installed language packs (read-only in compat API).

GET/api/v1.0/languages
GET/api/v1.0/languages/{id}

Settings

Store settings configuration.

GET/api/v1.0/settings
GET/api/v1.0/settings/{id}
PUT/api/v1.0/settings/{id}

Promotions

Promotion rules and discount campaigns.

GET/api/v1.0/promotions
GET/api/v1.0/promotions/{id}
POST/api/v1.0/promotions
PUT/api/v1.0/promotions/{id}
DELETE/api/v1.0/promotions/{id}

PromotionBanners

Banners linked to active promotions (read-only).

GET/api/v1.0/promotion_banners
GET/api/v1.0/promotion_banners/{id}

Marketplace

4 entities

Stores / Vendors

Vendor/company management. Both /stores and /vendors paths are supported as aliases.

Alias: /api/v1.0/vendors/* maps to the same handlers.

GET/api/v1.0/stores
GET/api/v1.0/stores/{id}
POST/api/v1.0/stores
PUT/api/v1.0/stores/{id}
DELETE/api/v1.0/stores/{id}

Usergroups

Usergroup definitions and privilege management.

GET/api/v1.0/usergroups
GET/api/v1.0/usergroups/{id}
POST/api/v1.0/usergroups
PUT/api/v1.0/usergroups/{id}
DELETE/api/v1.0/usergroups/{id}

Destinations

Shipping rate area / destination zone definitions (read-only).

GET/api/v1.0/destinations
GET/api/v1.0/destinations/{id}

Discussions

Product reviews / discussion threads.

GET/api/v1.0/discussions
GET/api/v1.0/discussions/{id}
POST/api/v1.0/discussions
DELETE/api/v1.0/discussions/{id}

Brazilian

7 entities

ExtraOrderFields

Fiscal note data from ERPs (NF-e number, series, key). Used by Charrua and ERP integrations.

PUT/api/v1.0/extra_order_fields/{order_id}

Request Body Fields

FieldType
link_notastring
codigo_pedido_erpstring
chave_notastring
xml_notastring
pdf_notastring
nota_fiscalstring
base64_xmlstring

DeliveryMethods

Shipping quote by product + zipcode. Used by storefront for real-time delivery estimates.

GET/api/v1.0/delivery_methods

Query Parameters

NameType
product_idinteger
zipcodestring
amountinteger

CreditScore

ClearSale CNPJ credit check for B2B customers.

POST/api/v1.0/credit_score

Request Body Fields

FieldType
CNPJstring

SellersAvailability

Vendor location lookup for geo-based delivery availability.

GET/api/v1.0/sellers_availability

Query Parameters

NameType
zipcodestring
product_idinteger

OrderLimit

B2B credit limit management per user per vendor.

PUT/api/v1.0/order_limit

Request Body Fields

FieldType
user_idinteger
company_idinteger
limit_amountstring

Subscribers

Newsletter subscriber management.

GET/api/v1.0/subscribers
GET/api/v1.0/subscribers/{id}
POST/api/v1.0/subscribers
DELETE/api/v1.0/subscribers/{id}

CallRequests

Callback request management (customer requests a phone call).

GET/api/v1.0/call_requests
GET/api/v1.0/call_requests/{id}
POST/api/v1.0/call_requests
DELETE/api/v1.0/call_requests/{id}

B2B

5 entities

BusinessPartners

B2B partner/company profiles for wholesale operations.

GET/api/v1.0/business_partners
GET/api/v1.0/business_partners/{id}
POST/api/v1.0/business_partners
PUT/api/v1.0/business_partners/{id}

Managers

Field sales managers / representatives.

GET/api/v1.0/managers
GET/api/v1.0/managers/{id}
POST/api/v1.0/managers
PUT/api/v1.0/managers/{id}
DELETE/api/v1.0/managers/{id}

PaymentCodes

B2B payment condition codes (payment terms, installment plans).

GET/api/v1.0/payment_codes
POST/api/v1.0/payment_codes

MixProducts

Mixed product bundles for B2B orders.

GET/api/v1.0/mix_products
POST/api/v1.0/mix_products

ManagerTransactions

Sales transaction records for field managers.

GET/api/v1.0/manager_transactions
POST/api/v1.0/manager_transactions

Vendor App

18 entities

VendorLogin

Vendor mobile app authentication and password reset.

POST/api/v1.0/vendor_login
PUT/api/v1.0/vendor_login

VendorSignup

New vendor registration from mobile app.

POST/api/v1.0/vendor_signup

VendorStart

App initialization data (config, permissions, menus).

GET/api/v1.0/vendor_start

VendorDashboard

Vendor dashboard summary (sales, orders, revenue).

GET/api/v1.0/vendor_dashboard

VendorCompany

Vendor company profile management.

GET/api/v1.0/vendor_company
PUT/api/v1.0/vendor_company

VendorProfile

Vendor user profile management.

GET/api/v1.0/vendor_profile
PUT/api/v1.0/vendor_profile

VendorCategories

Categories available to the vendor.

GET/api/v1.0/vendor_categories

VendorProducts

Vendor product listing and bulk delete.

GET/api/v1.0/vendor_products
POST/api/v1.0/vendor_products

VendorProduct

Single product CRUD from vendor mobile app.

GET/api/v1.0/vendor_product/{id}
POST/api/v1.0/vendor_product
PUT/api/v1.0/vendor_product/{id}

VendorProductOptions

Product options for vendor app product editor.

GET/api/v1.0/vendor_product_options

VendorProductAttachments

Product file attachments (datasheets, manuals).

GET/api/v1.0/vendor_product_attachments

VendorRequiredProducts

Required/accessory product associations.

GET/api/v1.0/vendor_required_products

VendorOrders

Vendor order listing.

GET/api/v1.0/vendor_orders

VendorOrder

Single order detail and status update from vendor app.

GET/api/v1.0/vendor_order/{id}
PUT/api/v1.0/vendor_order/{id}

VendorNotifications

Push notification history for vendor.

GET/api/v1.0/vendor_notifications

VendorChats

Customer-vendor chat/messaging.

GET/api/v1.0/vendor_chats
POST/api/v1.0/vendor_chats

VendorAuctions

Auction/bidding system for vendor products.

GET/api/v1.0/vendor_auctions
POST/api/v1.0/vendor_auctions

VendorUpload

File/image upload from vendor mobile app.

POST/api/v1.0/vendor_upload

Integrations

12 entities

MagentoOrders

Magento connector - order synchronization.

GET/api/v1.0/magento_orders
GET/api/v1.0/magento_orders/{id}
PUT/api/v1.0/magento_orders/{id}

MagentoProducts

Magento connector - product synchronization.

GET/api/v1.0/magento_products
GET/api/v1.0/magento_products/{id}
PUT/api/v1.0/magento_products/{id}

MagentoStores

Magento connector - store synchronization.

GET/api/v1.0/magento_stores
GET/api/v1.0/magento_stores/{id}
PUT/api/v1.0/magento_stores/{id}

Missions

Field mission tracking (Magento connector).

GET/api/v1.0/missions
PUT/api/v1.0/missions/{id}

MissionSurveys

Survey data collected during field missions.

GET/api/v1.0/mission_surveys
PUT/api/v1.0/mission_surveys/{id}

POSLogin

Point-of-sale terminal authentication.

GET/api/v1.0/pos_login

POSCheckout

Point-of-sale order placement.

POST/api/v1.0/pos_checkout

POSCustomers

Customer lookup from POS terminal.

GET/api/v1.0/pos_customers

POSProducts

Product catalog for POS terminal.

GET/api/v1.0/pos_products

SyncObjects

POS offline sync data (products, customers, orders).

GET/api/v1.0/sync_objects

Routes

Delivery route management for field sales.

GET/api/v1.0/routes/{manager_id}
POST/api/v1.0/routes
PUT/api/v1.0/routes/{id}
DELETE/api/v1.0/routes/{id}

Checkins

Field check-in records for delivery route tracking.

GET/api/v1.0/checkins/{manager_id}
POST/api/v1.0/checkins

Other

8 entities

Carts

Admin access to user carts (view and clear).

GET/api/v1.0/carts/{user_id}
DELETE/api/v1.0/carts/{user_id}

Wishlists

User wishlist management.

GET/api/v1.0/wishlists
POST/api/v1.0/wishlists
DELETE/api/v1.0/wishlists

Notifications

Marketing notification list (read-only).

GET/api/v1.0/notifications

MakeAnOffer

Price negotiation system (customer proposes a price).

GET/api/v1.0/make_an_offer
POST/api/v1.0/make_an_offer
PUT/api/v1.0/make_an_offer/{id}
DELETE/api/v1.0/make_an_offer/{id}

ProductBoxes

Kit/bundle product definitions.

GET/api/v1.0/product_boxes
GET/api/v1.0/product_boxes/{id}
POST/api/v1.0/product_boxes
PUT/api/v1.0/product_boxes/{id}
DELETE/api/v1.0/product_boxes/{id}
GET/api/v1.0/product_boxes_variants
GET/api/v1.0/product_boxes_descriptions

Charrua

Charrua ERP integration (field sales data sync).

GET/api/v1.0/charrua

InternalUsergroups

Internal usergroup override per company (ignore email matching).

PUT/api/v1.0/internal_usergroups/{company_id}

EC API Changes

Extended API entities (customers, user profiles, product variations, order extensions).

POST/api/v1.0/customers
GET/api/v1.0/user_profiles
POST/api/v1.0/user_profiles
PUT/api/v1.0/user_profiles/{id}
POST/api/v1.0/product_variations
PUT/api/v1.0/orders_ext/{id}

Need the modern API? View API v1 (REST) Reference →

212 endpoints across 74 entities