GTMS Provides ready-to-go REST APIs with supporting tools and documentation, which provides the basic information about Manufacturing industry template APIs.
\nThis Guides covers List of Interfaces in Manufacturing template, getting started guide, Authentication, Documentation of the Data Structures of the interfaces.
\nProduct Master
\nCustomer Master
\nSales Transactions
\nCondition Records
\nCustomer Contracts
\nBillback Contracts
\nCustomer Outgoing Payments
\nCustomer Outgoing Accruals
\nBillback Outgoing Payments
\nBillback Outgoing Accruals
\nBefore using these interfaces, Vistex will have to setup a tenant and provide the host URL & client credentials. will be generated and shared to the consumers.
\nThere are 2 ways of authorization we support.
\nOAuth2.0
\nBasic Authentication
\nRecommendation is to use OAuth2.0 over basic authentication unless there's a limitation on consumer side.
\nContact Vistex Support
\n","schema":"https://schema.getpostman.com/json/collection/v2.0.0/collection.json","toc":[{"content":"📄 Manufacturing GTMS Interface Guide","slug":"manufacturing-gtms-interface-guide"}],"owner":"32745970","collectionId":"a1a59eda-167a-4dd9-99c2-bb924cba74ce","publishedId":"2sA3duFCpP","public":true,"customColor":{"top-bar":"FFFFFF","right-sidebar":"303030","highlight":"FF6C37"},"publishDate":"2026-02-02T20:47:30.000Z"},"item":[{"name":"Products","item":[{"name":"Post Products","id":"5141270c-c38f-4d2d-a4a1-72952c6d4b7c","protocolProfileBehavior":{"disableBodyPruning":true},"request":{"method":"POST","header":[],"body":{"mode":"raw","raw":"{\r\n \"Header\": [\r\n {\r\n \"Action\": \"{Type: String, Title: Action, MaxLength: 1, Required:false}\",\r\n \"ProductType\": \"{Type: String, Title: Material Type, MaxLength: 4, Required:false,DefaultValue:WXPR}\",\r\n \"ProductID\": \"{Type: String, Title: External Identification, MaxLength: 128, Required:true}\",\r\n \"Description\": \"{Type: String, Title: Description, MaxLength: 40, Required:true}\",\r\n \"BaseUnitOfMeasure\": \"{Type: String, Title: Base Unit of Measure, MaxLength: 3, Required:true}\",\r\n \"Group1\": \"{Type: String, Title: Product Group 1, MaxLength: 10, Required:false}\",\r\n \"Group2\": \"{Type: String, Title: Product Group 2, MaxLength: 10, Required:false}\",\r\n \"Group3\": \"{Type: String, Title: Product Group 3, MaxLength: 10, Required:false}\",\r\n \"Supplier\": \"{Type: String, Title: Vendor, MaxLength: 10, Required:false}\",\r\n \"Group4\": \"{Type: String, Title: Product Group 4, MaxLength: 4, Required:false}\",\r\n \"Group5\": \"{Type: String, Title: Product Group 5, MaxLength: 4, Required:false}\",\r\n \"Group6\": \"{Type: String, Title: Product Group 6, MaxLength: 4, Required:false}\",\r\n \"Group7\": \"{Type: String, Title: Product Group 7, MaxLength: 4, Required:false}\",\r\n \"EANNumber\": \"{Type: String, Title: European Article Number, MaxLength: 128, Required:false}\",\r\n \"UPCNumber\": \"{Type: String, Title: Universal Product Code, MaxLength: 128, Required:false}\",\r\n \"MPNNumber\": \"{Type: String, Title: Manufacturer Part Number, MaxLength: 128, Required:false}\",\r\n \"GTNNumber\": \"{Type: String, Title: GTN, MaxLength: 128, Required:false}\",\r\n \"BussinessUnit\": [\r\n {\r\n \"BusinessUnit\": \"{Type: String, Title: Business Unit, MaxLength: 4, Required:false}\",\r\n \"Group7\": \"{Type: String, Title: Product Group 7, MaxLength: 10, Required:false}\",\r\n \"Group8\": \"{Type: String, Title: Product Group 8, MaxLength: 10, Required:false}\",\r\n \"Group9\": \"{Type: String, Title: Product Group 9, MaxLength: 4, Required:false}\",\r\n \"ProfitCenter\": \"{Type: String, Title: Profit Center, MaxLength: 4, Required:false}\"\r\n }\r\n ],\r\n \"UnitOfMeasure\": [\r\n {\r\n \"UnitOfMeasure\": \"{Type: String, Title: Unit of Measure, MaxLength: 3, Required:false}\",\r\n \"Numerator\": \"{Type: Decimal Nu, Title: Numerator, MaxLength: 5, Required:false}\",\r\n \"Denominator\": \"{Type: Decimal Nu, Title: Denominator, MaxLength: 5, Required:false}\",\r\n \"BaseUnitIndicator\": \"{Type: String, Title: Base Unit of Measure, MaxLength: 1, Required:false}\",\r\n \"Length\": \"{Type: Number, Title: Length, MaxLength: 13, Required:false}\",\r\n \"Height\": \"{Type: Number, Title: Height, MaxLength: 13, Required:false}\",\r\n \"Width\": \"{Type: Number, Title: Width, MaxLength: 13, Required:false}\",\r\n \"DimensionUnit\": \"{Type: String, Title: Dimension Unit, MaxLength: 3, Required:false}\",\r\n \"NetWeight\": \"{Type: Number, Title: Net Weight, MaxLength: 15, Required:false}\",\r\n \"GrossWeight\": \"{Type: Number, Title: Gross Weight, MaxLength: 15, Required:false}\",\r\n \"WeightUnit\": \"{Type: String, Title: Weight Unit, MaxLength: 3, Required:false}\",\r\n \"Volume\": \"{Type: Number, Title: Volume, MaxLength: 15, Required:false}\",\r\n \"VolumeUnit\": \"{Type: String, Title: Volume Unit, MaxLength: 3, Required:false}\"\r\n }\r\n ],\r\n \"Cost\": [\r\n {\r\n \"BusinessUnit\": \"{Type: String, Title: Business Unit, MaxLength: 4, Required:false}\",\r\n \"ValidFrom\": \"{Type: Date, Title: Valid From, MaxLength: 8, Required:false} \",\r\n \"ValidTo\": \"{Type: Date, Title: Valid To, MaxLength: 8, Required:false} \",\r\n \"CalculationRate\": \"{Type: Decimal Nu, Title: Rate, MaxLength: 24, Required:false}\",\r\n \"RateUnit\": \"{Type: String, Title: Unit, MaxLength: 5, Required:false}\",\r\n \"Per\": \"{Type: Decimal Nu, Title: Per, MaxLength: 24, Required:false}\",\r\n \"PerUnit\": \"{Type: String, Title: Unit, MaxLength: 5, Required:false}\",\r\n \"PayoutUnitType\": \"{Type: String, Title: Basis Unit Type, MaxLength: 4, Required:false}\"\r\n }\r\n ],\r\n \"Descriptions\": [\r\n {\r\n \"LanguageKey\": \"\",\r\n \"Description\": \"{Type: String, Title: Description, MaxLength: 40, Required:false}\"\r\n }\r\n ],\r\n \"Identifications\": [\r\n {\r\n \"IdentificationType\": \"{Type: String, Title: Identification Type, MaxLength: 4, Required:false}\",\r\n \"ProductIdentification\": \"{Type: String, Title: Material Identification, MaxLength: 128, Required:false}\"\r\n }\r\n ],\r\n \"HeaderWithDate\": [\r\n {\r\n \"ValidFrom\": \"{Type: Date, Title: Valid From, MaxLength: 8, Required:false} \",\r\n \"ValidTo\": \"{Type: Date, Title: Valid To, MaxLength: 8, Required:false} \",\r\n \"Group4\": \"{Type: String, Title: Product Group 4, MaxLength: 10, Required:false}\",\r\n \"Group5\": \"{Type: String, Title: Product Group 5, MaxLength: 10, Required:false}\",\r\n \"Group6\": \"{Type: String, Title: Product Group 6, MaxLength: 4, Required:false}\",\r\n \"Hierarchy\": \"{Type: String, Title: Product Hierarchy, MaxLength: 60, Required:false}\"\r\n }\r\n ],\r\n \"BussinessUnitWithDate\": [\r\n {\r\n \"BusinessUnit\": \"{Type: String, Title: Business Unit, MaxLength: 4, Required:false}\",\r\n \"ValidFrom\": \"{Type: Date, Title: Valid From, MaxLength: 8, Required:false} \",\r\n \"ValidTo\": \"{Type: Date, Title: Valid To, MaxLength: 8, Required:false} \",\r\n \"Group10\": \"{Type: String, Title: Product Group 10, MaxLength: 10, Required:false}\",\r\n \"Group11\": \"{Type: String, Title: Product Group 11, MaxLength: 10, Required:false}\",\r\n \"Group12\": \"{Type: String, Title: Product Group 12, MaxLength: 4, Required:false}\"\r\n }\r\n ],\r\n \"MultiValueAttrsGroup1\": [\r\n {\r\n \"MultiValueGroup1\": \"{Type: String, Title: Product Group 13, MaxLength: 4, Required:false}\"\r\n }\r\n ],\r\n \"MultiValueAttrsGroup2\": [\r\n {\r\n \"MultiValueGroup2\": \"{Type: String, Title: Product Group 14, MaxLength: 4, Required:false}\"\r\n }\r\n ],\r\n \"MultiValueAttrsGroup3\": [\r\n {\r\n \"MultiValueGroup3\": \"{Type: String, Title: Product Group 15, MaxLength: 4, Required:false}\"\r\n }\r\n ]\r\n }\r\n ]\r\n}","options":{"raw":{"language":"json"}}},"url":"https://<Create Product master, with reference to Product master entity in GTMS application. API Endpoint is 'Products', API definition is explained below with success and failure examples.
\n","auth":{"type":"oauth2","oauth2":{"clientSecret":"Hostname would be specific to the tenant/customer. API Endpoint is 'Products', below body shows the entire payload of Product Master API with each field characteristics.
\n","auth":{"type":"oauth2","oauth2":{"clientSecret":"API Endpoint: Products
\nThis GTMS interface supports all CRUD operations. Using this synchronous API enables you to Create, Change, Read & Delete Product Master details in/from GTMS.
\nProduct Master API holds Products, Materials, SkUs master data. This object has following data sections with cardinality mentioned for respective section in bracket.
\nHeader Data - General Data about the products.
\nHeader with Date - Header Attributes with Validity
\nBusiness Unit - General Data about the Business Unit
\nBusiness Unit with Date - Business Unit with Validity
\nIdentification - Various identification numbers for the Product
\nDescriptions - Long description in different languages
\nUnit of Measure - Data about the various Unit of Measurement
\nCost - Product cost data with validity
\nMulti Value Attributes Group - Group of Attributes having multiple values
\nSuccess & Failure examples are provided as reference.
\n","event":[{"listen":"prerequest","script":{"id":"ffbb5830-3d2d-4b2f-89af-1d34a4c13e1e","type":"text/javascript","packages":{},"exec":[""]}},{"listen":"test","script":{"id":"c9138814-4e67-49bd-855b-c73424168781","type":"text/javascript","packages":{},"exec":[""]}}],"_postman_id":"e83012f1-c747-477b-997e-d32f6b6d9b2c","auth":{"type":"oauth2","oauth2":{"clientSecret":"Hostname would be specific to the tenant/customer. API Endpoint is 'Customers', below body shows the entire payload of Customer Master API with each field characteristics.
\n","auth":{"type":"oauth2","oauth2":{"clientSecret":"Hostname would be specific to the tenant/customer. API Endpoint is 'Customers', below body shows the entire payload of Customer Master API with each field characteristics.
\n","auth":{"type":"oauth2","oauth2":{"clientSecret":"API Endpoint: Customers
\nThis GTMS Interface Supports all CRUD operations. Using this synchronous API enables you to Create, Change, Read & Delete Customer Master details in/from GTMS.
\nCustomer Master API stores Customer or Business partner master data. This object has following data sections with cardinality mentioned for respective section in bracket.
\nHeader Data - General Data about the Customers
\nHeader Attributes with Dates - Header Attributes with Validity
\nAddress - Different address detail like Standard address, Mailing Address , etc.
\nContact Methods - Detail about the Contact detail with preference like Email, Cell phone, etc..
\nBusiness Unit - General Data about the Business Unit
\nBusiness Unit with Date - Business Unit with Validity
\nCompany Attributes - General Data about the Company
\nIdentifications - Various identification numbers for the Customer
\nMulti Value Attributes Group - Group of Attributes having multiple values.
\nSuccess & Failure examples are provided as reference.
\n","_postman_id":"783b548b-bd75-49f3-931b-6e65444a7bd8","auth":{"type":"oauth2","oauth2":{"clientSecret":"Hostname would be specific to the tenant/customer. API Endpoint is 'SalesTransactions', below body shows the entire payload of Sales Transactions API with each field characteristics.
\n","auth":{"type":"oauth2","oauth2":{"clientSecret":"Hostname would be specific to the tenant/customer. API Endpoint is 'SalesTransactions', below body shows the entire payload of Sales Transactions API with each field characteristics.
\n","auth":{"type":"oauth2","oauth2":{"clientSecret":"API Endpoint: SalesTransactions
\nThis GTMS interface supports all CRUD operations. Using this synchronous API enables you to Create, Change, Read & Delete Sales Transactions in/from GTMS. This object has following data section with cardinality mentioned in bracket.
\nSuccess & Failure examples are provided as reference.
\n","_postman_id":"6af3ed4c-817a-457a-a116-8f8731085d80","auth":{"type":"oauth2","oauth2":{"clientSecret":"Hostname would be specific to the tenant/customer. API Endpoint is 'ConditionRecords', below body shows the entire payload of Condition Records API with each field characteristics.
\n","auth":{"type":"oauth2","oauth2":{"clientSecret":"Hostname would be specific to the tenant/customer. API Endpoint is 'ConditionRecords', below body shows the entire payload of Condition Records API with each field characteristics.
\n","auth":{"type":"oauth2","oauth2":{"clientSecret":"API Endpoint: ConditionRecords
\nThis GTMS API supports, all CRUD operations. Using this synchronous API enables you to read, Create, Change, Read & Delete Condition Records in/from GTMS. This object has following data section with cardinality mentioned in bracket.
\nSuccess & Failure examples are provided as reference.
\n","_postman_id":"fd9b8a95-36b0-4a0e-ae84-34cc62b7a08c","auth":{"type":"oauth2","oauth2":{"clientSecret":"Hostname would be specific to the tenant/customer. API Endpoint is 'SupplierOutgoingPayments', below body shows the entire payload of Supplier Outgoing Payments API with each field characteristics.
\n","auth":{"type":"oauth2","oauth2":{"clientSecret":"API Endpoint: SupplierOutgoingPayments
\nThis GTMS API supports, GET operation. Using this synchronous API enables you to Read Supplier rebate settlement Records in GTMS. All the required details are in Header and Item sections. This object has following data sections with cardinality mentioned for respective section in bracket.
\nSuccess & Failure examples are provided as reference.
\n","_postman_id":"e978edbe-4c30-416b-960d-8bcfa83f1df5","auth":{"type":"oauth2","oauth2":{"clientSecret":"Hostname would be specific to the tenant/customer. API Endpoint is 'SupplierOutgoingPayments', below body shows the entire payload of Supplier Outgoing Payments API with each field characteristics.
\n","auth":{"type":"oauth2","oauth2":{"clientSecret":"API Endpoint: SupplierOutgoingAccrual
\nThis GTMS API supports, GET operation. Using this synchronous API enables you to Read Supplier rebate accrual Records in GTMS. All the required details are in Header and Item sections. This object has following data sections with cardinality mentioned for respective section in bracket.
\nSuccess & Failure examples are provided as reference.
\n","_postman_id":"22b7013e-98a2-41d2-8ea0-927eee1d9c02","auth":{"type":"oauth2","oauth2":{"clientSecret":"Hostname would be specific to the tenant/customer. API Endpoint is 'CustomerOutgoingPayments', below body shows the entire payload of Customer Outgoing Payments API with each field characteristics.
\n","auth":{"type":"oauth2","oauth2":{"clientSecret":"API Endpoint: CustomerOutgoingPayments
\nThis GTMS API supports, GET operations. Using this synchronous API enables you to read Customer rebate settlement Records in GTMS. This object has following data sections with cardinality mentioned for respective section in bracket.
\nSuccess & Failure examples are provided as reference.
\n","_postman_id":"b7a05702-4e19-4c42-a32a-967ac5e248d9","auth":{"type":"oauth2","oauth2":{"clientSecret":"Hostname would be specific to the tenant/customer. API Endpoint is 'CustomerOutgoingPayments', below body shows the entire payload of Customer Outgoing Payments API with each field characteristics.
\n","auth":{"type":"oauth2","oauth2":{"clientSecret":"API Endpoint: CustomerOutgoingAccrual
\nThis GTMS API supports, GET operations. Using this synchronous API enables you to read Customer rebate accrual Records in GTMS. This object has following data sections with cardinality mentioned for respective section in bracket.
\nHeader - General data related to payment such as payment reference, net value, currency, company, etc.
\nItems - Payment item detail, such as amount, currency, Product, Product groups, Customer Groups, etc..
\nSuccess & Failure examples are provided as reference.
\n","_postman_id":"61c695ce-34b9-45d0-96f6-f4a5ddd0b144","auth":{"type":"oauth2","oauth2":{"clientSecret":"