API · Webhooks · SSO · ERP · CRM · HR
SDK and integration with customer systems
How Corp-Merch.MX connects with the ERP, CRM, HR platform and vendor portal of the customer. SDKs and integrations support token authentication, webhooks for event notification, SSO for corporate portals and data export in standard formats.
Connection with customer ERP
Corporate customers with mature ERP — SAP S/4HANA, Oracle Cloud ERP, Microsoft Dynamics 365, Infor LN — request integration via REST API with OAuth 2.0 or service token authentication. The integration supports three main use cases. The first is automatic creation of purchase orders from a customer system event, generally an approved request for uniforms, welcome kits or personnel replacements. The second is order status query to display to the buyer on their own screen without entering the workshop portal.
The third is download of CFDI 4.0 invoices and payment complements directly to the customer's accounts payable module. The invoice is delivered in XML and PDF format signed by SAT, with reference to the order, the receptor and the UUID. For customers with three-level approval scheme — buyer, manager, director — the integration respects the customer's internal flows and notifies the workshop when final approval is reached.
Connection with CRM and sales platforms
For customers with CRM — Salesforce, HubSpot, Pipedrive, Zoho — the integration is used mainly in merch for recognition campaigns, key customer gifts and fair kits. The CRM emits the commercial event — deal closure, contract renewal, referral, fair attendance — and the integration triggers the corresponding merch order with recipient data, shipping address and campaign reference. The recipient receives the merch without manual commercial area intervention.
For marketing campaigns with high volume — over one thousand recipients per month — the integration connects with the marketing platform to coordinate shipping with communication. The recipient receives the email or message with their tracking number and can confirm delivery from their own interface, without the customer having to manage confirmation manually.
Connection with HR platforms
HR platforms — Workday, BambooHR, Rippling, SAP SuccessFactors — are the main source of events that trigger merch: employee hire, anniversary, promotion, departure. Integration with HR allows configuring rules — for example, welcome kit within five days of hire, anniversary gift at multiples of five years, promotion recognition from a certain level — and letting the system operate without manual intervention.
For corporate customers with over one thousand employees in Mexico and a mature HR platform, the integration with Corp-Merch.MX happens during the customer onboarding process. Typical integration duration is four to eight weeks, depending on the customer's security scheme, volume and internal validations. Deliverable includes technical documentation, test cases, sandbox and production environments, and post-go-live support for the first thirty days.
SSO and corporate portals
For customers who prefer to operate from their own corporate portal we offer SAML 2.0 or OpenID Connect authentication against their corporate IdP — Okta, Azure AD, Google Workspace, Auth0, Ping Identity. The customer user accesses the Corp-Merch.MX portal with their same corporate credentials, without maintaining an additional user. Authorisation is controlled by IdP groups and mapped against portal roles.
For customers with a customised vendor portal, integration happens via iframe or REST API with SSO in the header. The customer user remains in their portal and workshop information renders as an embedded module. For customers with internal mobile app we publish mobile-optimised REST endpoints with compact response and short-duration JWT token authentication.
Webhooks and events
The system publishes webhooks so the customer receives notifications of relevant events — order created, artwork approved, production started, quality control, shipment made, delivery confirmed. Each event carries a JSON payload with minimum necessary information and a unique identifier for deduplication. The customer can configure the endpoint and the set of events they want to receive; unconsumed events are retried with exponential backoff for twenty-four hours.
Webhook security is guaranteed with HMAC-SHA256 signature on the payload, with shared key rotated every ninety days. The customer verifies the signature before processing the event; events with invalid signature are rejected and logged. The documentation includes payload examples for each event type and the error codes the customer may receive.
Data catalogue and export format
The product catalogue is exposed via REST API with pagination, filters and search. Each product includes internal reference, name, description, variants, MOQ, lead time, base price, applicable regulatory constraints and customisation options. Synchronisation with the customer's catalogue happens by event — creation, deletion, price change, variant change — or by full snapshot on demand.
Data export supports JSON, CSV and XML formats, with UTF-8 encoding and standard separators. For customers with data warehouses we offer export in Parquet format. The documentation includes the data dictionary, format examples and integration recommendations with the customer's analytics systems.
FAQ — SDK block
How long does SAP integration take?
Integration with SAP S/4HANA takes between six and ten weeks, depending on scenario complexity and customer internal validations. Includes sandbox and production environments and thirty days of post-go-live support.
Do you support Workday?
Yes. We integrate with Workday for welcome kit, anniversary and recognition. Connection happens via REST API with OAuth 2.0 authentication.
Do webhooks retry?
Yes. Unconsumed events are retried with exponential backoff for twenty-four hours. HMAC-SHA256 signature guarantees payload authenticity.
Do you charge for integration?
Basic integration is included in the customer programme. Complex integrations with SAP, Oracle or HR platforms are quoted separately per scope and included in the commercial proposal.
Let's discuss your integration
If your company is evaluating connecting the merch programme with your ERP, CRM or HR platform, let's talk. We deliver the technical specification, supported use cases and an initial quote based on integration scope.
The integrations described on this page reflect the scenarios supported at the time of publication. Availability of each integration depends on the customer's source system, their security scheme and their internal validations. Corp-Merch.MX is a Mexican workshop for corporate merch production; we operate independently and the technical information on this page does not constitute integration advice or contractual commitment until confirmed in writing by the commercial and technical areas.