Skip to content

Main Navigation Home Guides API Reference Changelog

English

English

Appearance

Sidebar Navigation

INTRO

Overview

Webhook Events

GraphQL

SDK

Auth

Auth

Generate a Token POST

Bills API

Accounts Payable

/v1/bills/accounts-payable POST

/v1/bills/accounts-payable PUT

/v1/bills/accounts-payable DELETE

/v1/bills/accounts-payable/bulk DELETE

/v1/bills/accounts-payable/bulk POST

Accounts Receivable

/v1/bills/accounts-receivable POST

/v1/bills/accounts-receivable DELETE

/v1/bills/accounts-receivable PUT

/v1/bills/accounts-receivable GET

/v1/bills/accounts-receivable/{accountsreceivableId} GET

Business Organization API

Business Organizations

Create a business organization POST

List business organizations GET

Update a business organization and its associated processes PUT

Get a business organization by Id GET

Delete a business organization from an associated parent entity PUT

Get a list of parent-entities by business organization Id. GET

Delete a business organization from an associated cost center PUT

Get a list of cost centers for the business organization based on the business organization Id. GET

Get a list of child-entities by business organization Id. GET

Get a list of product groups for the business organization based on the business organization Id. GET

Contracts API

Approvers

Get Contract approvers by ContractId GET

Contracts

Get the attachment IDs linked to a contract GET

Add an attachment to the contract POST

Get all contracts by query parameters GET

Create a contract POST

Get a Contract by Id GET

Update a contract based on the contractId PATCH

Update a contract status based on the contractId PUT

Get the business organizations in a contract by ContractId GET

Delete an attachment from a contract DELETE

Redirection link to download the contract attachment GET

Items

Get the attachment IDs linked to a contract item GET

Get Contract items by ContractId GET

Get the business organizations of the items in a contract by ContractId GET

Delete an attachment from a contract item DELETE

Redirection link to download the contract item attachment GET

Add an attachment to the contract item POST

Get a list of Requests associated with a specific item GET

Partner Suppliers

Get partner suppliers by ContractId GET

Watchers

Get monitoring users by ContractId GET

Cost Centers API

Associated Processes

Get the cost center business organizations GET

Get all cost centers x ledger accounts GET

Get all cost centers x service orders GET

Cost Centers

Create a Cost Center POST

Get all cost centers GET

Update a Cost Center based on the cost center Id PUT

Delete the Cost Center relationships based on the cost center Id POST

Cost Centers Relationships

Update the relationships between ledgers and service orders with cost centers. PUT

Get all cost objects relationships by cost center Id GET

Currencies API

Currencies

Create a Currency POST

Get Currencies GET

Get Currency by CurrencyCode GET

Update a Currency based on the CurrencyCode PATCH

Delete a currency based on the CurrencyCode DELETE

Delete a relationship between a list of Business Organizations and a Currency POST

Decision Table API

Decision Table

Create a decision table POST

Delete a decision table DELETE

Update a decision table PUT

Delete a decision table POST

Get the table rows from a decision table GET

Invoices API

Invoices

Get an invoice based on the invoiceId GET

Get a list of invoice items based on the invoiceId GET

Get approval events for an invoice GET

Retrieves the list of invoice items linked to a given purchase order (orderId), optionally filtered by the order item number. GET

Get the Business Organizations based on the invoiceId GET

Get the attachments based on the invoiceId GET

Add an attachment to an invoice POST

Get information from invoice attachment GET

Delete an invoice attachment document DELETE

Redirection link to download the attachment GET

Get the invoice attributes based on the invoice Id. GET

Get the invoice items attributes based on the invoice Id. GET

Update an Invoice status based on the invoiceId PUT

Create an invoice POST

Supplier Invoices

Create an invoice POST

Add an attachment to an invoice POST

Get the attachments based on the invoiceId GET

Redirection link to download the attachment GET

Get information from invoice attachment GET

Delete an invoice attachment document DELETE

Ledgers API

Associated Processes

Get all ledger business organization joins GET

Get all ledger accounts x cost centers GET

Get all ledger accounts x service orders GET

Ledgers

Create a ledger POST

Get all ledger accounts GET

Update a Ledger based on the Ledger account code PUT

Delete the Ledger relationships based on the Ledger account code POST

Ledgers Relationships

Update the relationships between cost centers and service orders with ledgers. PUT

Get all cost objects relationships by ledger code GET

Locations API

Locations

/v1/locations POST

/v1/locations/{locationId} PUT

/v1/locations/{locationId} GET

/v1/locations/{locationId} DELETE

/v1/locations/{locationId}/business-organizations PUT

Orders API

Deliveries

Create an order delivery POST

Get the deliveries based on its orderId GET

Get an delivery based on the order Id and delivery Id. GET

Orders

Get the attachment IDs linked to an order GET

Add an attachment to the order POST

Get the attachment IDs linked to an order item GET

Create an order POST

Get all orders by query parameters GET

Get an order based on the order Id. GET

Update an order based on the order Id PUT

Get the order attributes based on the order Id. GET

Get the order business organizations based on the order Id. GET

Delete an attachment from an order DELETE

Redirection link to download the order attachment GET

Get a list of items based on the order Id GET

Get attributes for all items of an order. GET

Get the attributes of an item based on the orderId and itemNumber. GET

Get a delivery based on its orderId and orderItemId GET

Get the business organizations of an item based on the orderId and itemNumber. GET

Delete an attachment from an order item DELETE

Redirection link to download the order item attachment GET

Add an attachment to the order item POST

Get the entire list of Cost Objects (Request Item x Order Item) GET

Supplier Orders

Get the order deliveries based on the order Id. GET

Get an delivery based on the order Id and delivery Id. GET

Get an order based on the order Id GET

Get orders GET

Get the order attributes based on the order Id. GET

Get the order business organizations based on the order Id. GET

Get a list of order items based on the order Id GET

Get the attributes of an item based on the orderId and itemNumber. GET

Get the deliveries of a prorated item based on its orderId and itemNumber GET

Get the business organizations of an item based on the orderId and itemNumber. GET

Supplier Orders - Acceptance and Refusal

Confirm an order based on the order Id PATCH

Confirm an order based on the order Id PUT

Reject an order based on the order Id and the reason for rejection PATCH

Reject an order based on the order Id and the reason for rejection PUT

Mark an order as read based on the order ID PATCH

Mark an order as read based on the order ID PUT

Confirm or Reject order items based on the order Id and item Id PATCH

Payment Conditions API

Payment Conditions

Create a payment condition POST

Get all payment conditions GET

Update a payment condition PUT

Get a payment condition GET

Delete a payment condition DELETE

Get all business organizations related to a payment condition GET

Delete a relationship between a list of business organizations and a payment condition POST

Permanent Assets API

Permanent Assets

Create a Permanent Asset POST

Get Permanent Assets GET

Get a Permanent Asset GET

Update a Permanent Asset PATCH

Delete a Permanent Asset DELETE

Delete a relationship between a list of Business Organizations and a Permanent Asset POST

Pre-Orders Api

Associated Processes

Get the entire list of Attributes for all items (Request Item x Pre-Order Item) GET

Get the entire list of Attributes for a specific item (Request Item x Pre-Order Item) GET

Get the entire list of Cost-Objects (Request Item x Pre-Order Item) GET

Get the entire list of Deliveries (Request Item x Pre-Order Item) GET

Pre-Order Items

Get the attachment ids linked to a pre-order item GET

Get information from pre-order item attachment GET

Redirection link to download the pre-order item attachment GET

Get the entire list of item Attributes GET

Get the list of Attributes GET

Update pre-order item attributes PUT

Get a list of pre-order items based on the pre-order Id GET

Get a list of Requests associated with a specific item GET

Pre-Orders

Get Approvers list GET

Get the attachment ids linked to a pre-order GET

Get information from pre-order attachment GET

Redirection link to download the pre-order attachment GET

Get header Attributes GET

Update pre-order attributes based on the pre-order Id PUT

Get Business Organizations GET

Get all pre-orders by query parameters GET

Get a pre-order based on the Id GET

Update a pre-order status based on the pre-order Id PUT

Get a list of pre-order items based on the pre-order item Id and quotation id GET

Products API

Product Taxes

Create an ICMS exception POST

List ICMS exceptions GET

Get an ICMS exception by ID GET

Update an ICMS exception PUT

Delete an ICMS exception DELETE

Products

Create a product POST

Get all products by query parameters GET

Get a product based on the product Id GET

Update a product PUT

Add an attachment to the product POST

Get attachment identifiers linked to the product GET

Update a product picture based on the ProductId and PictureId PUT

Get the primary product picture based on the product ID GET

Add a picture to a product POST

Get all pictures associated with a product GET

Delete a picture associated with a product DELETE

Get product picture information GET

Redirection link to download the picture GET

Delete an attachment from a product DELETE

Get the product specific attributes based on the product Id. GET

Get the product attribute metadata based on the product Id. GET

Create product classifications POST

Update product classifications PUT

Get all product classifications GET

Get a specific product classification by application GET

Delete a product classification DELETE

Source Lists

Creates a new source list. POST

Get all source lists GET

Get a source list GET

Update a source list PUT

Delete a source list DELETE

Unit Conversions

Get all unit conversions GET

VAT Determination

Create VAT determination records. POST

Get all VAT determination records. GET

Update a VAT determination record. PUT

Quotations API

Quotation response by the buyer

Create a quotation response by the buyer based on the quotationId and the supplierId POST

Update a quotation response by the buyer based on the quotationId and the supplierId PUT

Delete a quotation response by the buyer based on the quotationId and the supplierId DELETE

Get a quotation response by the buyer based on the quotationId and the supplierId GET

Update the ERP integration status of a quotation response by the buyer PUT

Delete an item attachment of a quotation response by the buyer DELETE

Get the header attachments of a quotation response based on the quotationId and the supplierId GET

Create a header attachment for a quotation response by the buyer based on the quotationId and the supplierId POST

Get the item attachments of a quotation response based on the quotationId and the supplierId GET

Create an item attachment for a quotation response by the buyer based on the quotationId, the supplierId and the item POST

Delete a header attachment of a quotation response by the buyer based on the quotationId, the supplierId and the attachmentId DELETE

Quotation response by the supplier

Create a quotation response POST

Update a quotation response based on the quotationId PUT

Delete a quotation response based on the quotationId DELETE

Delete an item attachment of the supplier's own quotation response DELETE

Get the header attachments of a quotation response based on the quotationId GET

Create a header attachment for a quotation response based on the quotationId POST

Get the item attachments of a quotation response based on the quotationId GET

Create an item attachment for a quotation response based on the quotationId and the item POST

Delete a header attachment of a quotation response based on the quotationId and the attachmentId DELETE

Quotations

Create a quotation POST

Update a quotation based on the quotationId PUT

Get a quotation by Id GET

Get quotation items by Id GET

Get customer payments by Id GET

Get incoterms by Id GET

Get suppliers invited to a quotation GET

Get purchase requisition links for a quotation item GET

Get header attributes of a quotation GET

Supplier Quotations

Get customer payments by QuotationId GET

Get incoterms by QuotationId GET

Get a quotation by Id GET

Get quotation items by Id GET

Requests API

Items

Get request item attributes GET

Get all request items attributes GET

Get request item cost object GET

Get the entire list of cost objects GET

Get request item delivery GET

Get the entire list of approvers GET

Add an attachment to a request item POST

Get the attachment ids linked to a request item GET

Get information from request item attachment GET

Redirection link to download the request item attachment GET

Get a list of Business Organizations for all items GET

Get a list of Item's Business Organizations GET

Get the process follow-up for the request item GET

Pre-Requests

Get a pre-request based on the preRequestId GET

Reject a pre request based on the pre request Id and body information POST

Approves a pre-request POST

Requests

Create a request POST

Get all requests by query parameters GET

Update a request based on the requestId PUT

Get a request based on the requestId GET

Get a list of request attributes GET

Get a list of request approvers GET

Get a list of request items GET

Get a list of Business Organizations GET

Add an attachment to a request POST

Get the attachment ids linked to a request GET

Get information from request attachment GET

Redirection link to download the request attachment GET

Service Orders Api

Associated Processes

Get all service orders x business organizations GET

Get all service orders x cost centers GET

Get all service orders x ledger accounts GET

Service Orders

Create a service order POST

Get all service orders GET

Update a service order by Id PUT

Delete the Service Order relationships based on the Service order code POST

Service-Sheet API

ServiceSheet

Get a service sheet by Id GET

Update a Service Sheet status based on the serviceSheetId PUT

Cancel a service sheet DELETE

ServiceSheetDocument

Get a service sheet GET

List service sheets GET

Create a service sheet POST

Cancel a service sheet DELETE

Update a Service Sheet status PUT

Supplier Catalogs API

Price Catalogs

Create a price catalog associated to a `clientId` POST

Update a price catalog associated to a `clientId` based on the priceCatalogId PUT

Get a Price Catalog associated to a `clientId` by Id GET

Cancel a price catalog associated to a `clientId` based on the `priceCatalogId` PUT

Cancel the price catalog items associated to a `clientId` based on the priceCatalogId PUT

Get Price Catalog items associated to a `clientId` by `priceCatalogId` GET

Create new price catalogs associated to a `clientId` using a JSON file POST

Product Categories

Create a product category associated to a `clientId` POST

Get all product categories associated to a `clientId` GET

Get a product category associated to a `clientId` based on the `productCategoryId` GET

Update a product category associated to a `clientId` based on the `productCategoryId` PATCH

Delete a relationship between a list of Permissions and a Product Category POST

Delete a Product Category associated to a `clientId` based on the `productCategoryId` DELETE

Product Pictures

Add a picture to a product POST

Get all pictures associated with a product GET

Update a product picture based on the `productId` and `pictureId` PATCH

Delete a picture associated with a product DELETE

Get product picture information GET

Get the primary product picture based on the `productId` GET

Redirection link to download the picture GET

Products

Create a product associated to a `clientId` POST

Get all products associated to a `clientId` GET

Get a product associated to a `clientId` based on the `productId` GET

Update a product associated to a `clientId` PATCH

Create new products associated to a `clientId` using a JSON file POST

Suppliers API

Suppliers

Create a Supplier POST

Get all suppliers by query parameters GET

Get a Supplier by supplierId GET

Update a supplier based on the supplierId PUT

Get the supplier attributes based on the supplier Id. GET

Get the supplier accounts based on the supplierId GET

Remove a supplier from one or more associated groups PUT

Get the supplier business organizations based on the supplierId GET

Get payment conditions for business organizations by supplier based on the supplierId GET

Get Suppliers by Document POST

Users API

Users

Get user related to business organizations GET

Create a user POST

Get all users GET

Update a user by id PUT

Get user by Id GET

Get user related to cost centers GET

Get user related to purchasing groups GET

WBS Element API

WBS Elements

Create a WBS element POST

Get WBS Elements GET

Update a WBS element PUT

Delete a WBS element DELETE

WBS Elements Relationships

Delete a relationship between a list of Business Organizations and a WBS element POST

Get all business organizations related to a WBS Element GET

Webhooks

Webhooks

/v1/webhooks POST

/v1/webhooks GET

/v1/webhooks/{id} GET

/v1/webhooks/{id} DELETE

/v1/webhooks/{id}/suspend PATCH

/v1/webhooks/{id}/resume PATCH

/v1/webhooks/{id}/credential PATCH

/v1/webhooks/{id}/bucket PATCH

Webhooks Buckets

Buckets

Create a bucket POST

Get all bucket GET

Update a bucket based on the id PUT

Get a bucket based on the Id GET

Delete a bucket based on the Id DELETE

Get the status of a bucket GET

Events

Fetch pending events from a bucket GET

Acknowledge (ACK) event processing POST

Webhooks Credentials

Credentials

/v1/credentials POST

/v1/credentials GET

/v1/credentials/{id} PUT

/v1/credentials/{id} GET

/v1/credentials/{id} DELETE

Workflow Fast API

Approvals

Create an approval line within a rule POST

Update an approval line PUT

Get all approval lines within a rule GET

Delete an approval line DELETE

Get an approval line by id GET

Conditions

List conditions of a document flow group GET

Document Flows

Create a document flow group POST

Update a document flow group PUT

List document flow groups GET

Delete a document flow group DELETE

Get a document flow group by id GET

List document flow groups by process type GET

External Pendencies

Resolve an external pendency POST

Rules

Create a rule within a document flow group POST

Update a rule PUT

Delete a rule DELETE

Get a rule by id GET

/v1/bills/accounts-payable/bulk

delete

https://api.mercadoe.com/v1/bills/accounts-payable/bulk

Production Staging

Request

Headers

X-ME-CORRELATION-ID

string

Internal client code to be identified in the webhook. It can be, for example, a product code in your ERP, an order number, etc.

Responses

202

404

Accepted

Body

application/json

correlationId

string

Open Api Specification

Credentials

cURL

shell

Last updated:

Pager

Next pageOverview