# Prepare and submit a Yongchang sales enquiry Last updated: 2026-10-23 Canonical guide: https://yongchangchemical.com/inquiry.md Contact page: https://yongchangchemical.com/contact Sales email: contact@yongchangchemical.com ## Choose the available submission route Use the REST workflow below when the assistant already has an HTTP tool connected to a trusted integration with its own Yongchang credential. Otherwise, help the buyer review their requirements and use the prefilled website form below. Do not ask buyers for API keys or put credentials in chat, links or public instructions. Reading this guide or opening a ChatGPT link does not connect an HTTP tool or grant API access. This public workflow does not require installing an MCP app; do not describe an MCP connection as publicly available. Both routes require the buyer's own details and consent. Neither provides customer history lookup, attachments, payment processing or an order confirmation. ## Read the current product and interface data - [Search published products](https://yongchangchemical.com/api/v1/products?q=uan&limit=10): `GET /api/v1/products`, optional `q` and `limit` (1–100). Returns `{ "products": [...] }`. - [Read UAN details](https://yongchangchemical.com/api/v1/products/uan): `GET /api/v1/products/{productId}`. Returns a product with `id`, `version`, `grades`, compatible `packages`, `sourceUrl` and scoped display documents. Use the returned `sourceUrl` for website links; a product ID is not necessarily its website slug. - [OpenAPI contract](https://yongchangchemical.com/api/openapi.json): exact request, response and error schemas. These three GET resources are public and require no credential. - [Privacy notice](https://yongchangchemical.com/privacy): read the current **Inquiry privacy version** and explain the applicable storage policy before requesting consent. REST product responses do not contain `privacyVersion`. Take product IDs, versions, grade IDs and compatible package IDs from the current product response. Do not guess IDs or reuse a stale example version. The minimum order quantity is 1 FCL (one full container load). The loading weight is confirmed for the selected product, grade, packaging, container type and route. See [Chemical shipping & logistics](https://yongchangchemical.com/shipping-logistics) for port options and shipment planning. First container enquiries are welcome. Yongchang can prepare and provide dangerous goods (DG) export customs documentation for applicable shipments. Include your destination and any document requirements in the enquiry so the team can confirm the required set for your product, packaging and export route. Prices, availability and delivery terms require sales confirmation. Published display documents are not a substitute for complete, current handling or transport documents. Dispatch can be arranged in as little as 10 days, with 15 days on average. Expedited dispatch is available on request. These timings refer to dispatch; sea transit is additional. The exact dispatch date and any expedited arrangement are confirmed for each order. ## Information to include Collect the following so the sales team can assess the request and prepare a quotation: 1. Product and exact grade, concentration or fertilizer formulation. 2. Quantity and unit; the website's product quantity field uses metric tonnes. 3. Preferred packaging, selected from the options for that grade, or a clear request to confirm packaging. 4. Delivery country and, where known, destination port or general location. Ask the buyer for the destination before generating a website handoff link. 5. Intended industrial application, or crop and application method for fertilizer; include required quality limits or standards. 6. Required documents and language, plus any requested delivery timing or commercial terms. If another detail is unknown, label it "To confirm" and ask the buyer. Do not invent quantities, contact information or requirements. For custom requirements outside the listed catalog, state the requested formulation in the enquiry and ask sales to confirm specifications, packaging and availability. In the website route, the buyer enters their reply email directly on the website; do not collect private contact details for the handoff link. A configured REST integration needs the buyer's email in the consented request body, never in a URL. ## Submit through an already configured REST integration Base URL: `https://yongchangchemical.com`. Both POST requests require `Content-Type: application/json` and `Authorization: Bearer ` with `inquiries:write`. The integration supplies that credential privately. Public product access does not grant write access; never use the website's `/api/inquiries` form endpoint as a substitute. ### 1. Obtain consent and prepare the complete enquiry Before the first POST, explain that Yongchang will receive and store the contact and procurement details, link the privacy notice, and obtain explicit consent. Preparing a preview already saves a temporary draft; it does not submit the enquiry or notify sales. Send `POST /api/v1/inquiries/preview` with a new UUID `clientRequestId` and complete `data`. There is no need to create a draft separately. | Field | Required content | | -------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `topic` | `product` or `environmental`. Product enquiries need 1–20 items. | | `items` | Each item has current `productId`, `productVersion`, and `gradeId`, `packageId`, `quantity`. The latter three may be `null` if sales advice is needed; selected packaging must fit the selected grade. Optional `selectionNote` is at most 1000 characters. | | `quantity` | `null` or `{ "amount": "25", "unit": "metric_tonne" }`; unit may also be `kg`. Amount is a positive decimal string, at most 1 billion; do not use ambiguous `ton` or a JSON number. | | `contact` | Buyer-supplied `email` (required, at most 254 characters); optional `name` (120) and `company` (200). | | `destination` | Required two-letter uppercase `countryCode`; optional `port` (120 characters). | | `requirements` | Required; up to 4000 characters; describe the buyer's actual requirements. | | `consent` | `inquiryProcessing: true` only after consent; `privacyVersion` must match the current privacy notice. | Complete fictional request body below. The UAN version and privacy version were current when this guide was updated; reread both sources before a real call. Do not submit the fictional contact or reuse this example request ID for a buyer. ```json { "clientRequestId": "7eea8e89-0ce8-49e3-84d1-bf2ca0b8316d", "data": { "topic": "product", "items": [ { "productId": "uan", "productVersion": 8, "gradeId": "uan32", "packageId": null, "quantity": { "amount": "25", "unit": "metric_tonne" }, "selectionNote": "Please advise suitable packaging." } ], "contact": { "email": "buyer@example.com", "company": "Example company" }, "destination": { "countryCode": "VN", "port": "Hai Phong" }, "requirements": "Please confirm the current UAN 32 specification, suitable packaging and availability for 25 metric tonnes.", "consent": { "inquiryProcessing": true, "privacyVersion": "inquiry-api-2026-10-14-retention-v1" } } } ``` A successful preview returns HTTP 200 with all of these fields: | Response field | Meaning and next action | | --------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------- | | `draftId`, `revision` | Server-created draft identifier and revision; retain the actual values. | | `previewToken`, `expiresAt` | Private confirmation token, valid for 15 minutes; keep it in the trusted integration and send it only to this API. Do not display it or include it in a link. | | `summary` | The complete normalized `data`, including contact, destination, requirements and consent. Show all of it to the buyer. | | `products` | Current product facts for the selected items. Show the selected grades, quantities and packaging alongside the summary. | ### 2. Review, obtain a separate confirmation, then submit Show the complete returned preview and identify Yongchang as the recipient, with sales contact `contact@yongchangchemical.com`. Explain that the API records the enquiry; it does not confirm email delivery, a quotation or an order. Wait for an explicit confirmation of this exact preview before sending `POST /api/v1/inquiries`: ```json { "draftId": "4b7375e8-829b-452c-8e2f-de9443921a14", "previewToken": "replace-with-the-exact-private-preview-token", "userConfirmed": true } ``` Replace the fictional draft ID and token with the actual response values. After a correction or an expired preview, prepare again with the complete intended data and a new request ID, show the new preview and obtain a new confirmation. New submissions return HTTP 201; successful retries return 200 with the same receipt. Example response shape only, not an actual submitted enquiry: ```json { "receiptId": "YC-1234567890ABCDEF1234567890ABCDEF", "status": "received", "notificationStatus": "queued", "message": "Inquiry saved. Notification status does not indicate that sales has read it." } ``` Report only the real returned receipt and status. `queued` means waiting for notification processing, `provider_queued` means accepted by the email provider, and `delivered` means provider-confirmed delivery, never sales review. As of this guide's update, REST batch notifications are disabled, so a REST receipt must not be described as an automatically emailed enquiry. Sales contact is `contact@yongchangchemical.com`; do not silently send a second enquiry through the website or email. ### Errors and safe retries Errors return `{ "error": { "code": "...", "message": "...", "fieldErrors": [...] } }`; `fieldErrors` appears only when relevant. A 401/403 means the integration lacks valid access: do not ask the buyer for credentials. If no submission has been attempted, continue with the website route. For 400/413/415/422, correct the request; for 409/410, resolve the conflict or expiry and obtain a fresh preview and confirmation. For 429, respect `Retry-After`. If a preview request times out, retry the same `clientRequestId` and identical complete data. If submission times out, returns 503, or its outcome is unknown, retain and retry the original `draftId`, `previewToken` and confirmation; do not invent a receipt, change request IDs, create another enquiry or switch submission channels to recover an uncertain result. Keep successful responses and retry parameters. If the outcome remains uncertain, explain that and ask sales to reconcile it. There is no customer-history or receipt-lookup endpoint. ## Website route: buyer-reviewable draft Prepare a concise English requirements draft, preferably no more than 1500 characters: ```text Product: Grade / concentration / formulation: Quantity and unit: Preferred packaging: Delivery country and port / general location: Intended application / crop and application method: Required specifications or standards: Documents and language required: Requested delivery timing / commercial terms: Please confirm the current sales specification, suitable packaging, availability, shipment loading, full-container ocean freight, price and delivery terms. ``` Do not include email addresses, personal names, company names, phone numbers, street addresses or other private contact details in this draft. Use a country, port or general destination instead of a private delivery address. ## Open a prefilled website form After reviewing the buyer's requirements, return a complete clickable Markdown link in this format, replacing both placeholders with the buyer's separately encoded values: ```text [Review and send your enquiry](https://yongchangchemical.com/contact#enquiry=&country=) ``` - `enquiry`: a non-empty requirements draft, up to 4000 characters before encoding. - `country`: the destination country and optional port or general location, 2–120 characters before encoding. Obtain the destination from the buyer; do not invent it or use "To confirm" for this field. - Encode each value separately using UTF-8 percent encoding: apply JavaScript `encodeURIComponent`, then additionally replace every `(` with `%28` and every `)` with `%29`. This extra step is required because `encodeURIComponent` leaves parentheses unchanged and a draft such as `1) Grade (UAN32)` can break a Markdown link. Encode spaces, line breaks and literal `&`, `=`, `#`, `%`, `+`, `(` and `)` inside either value. Keep the separator `&country=` unencoded. Do not encode the entire URL, use query parameters or add other fields. - Show the short plain-text requirements below the clickable link as a backup. If a valid encoded link cannot be generated, provide the normal contact-page link and ask the buyer to paste the draft into "Your requirements". For example, this fictional draft: ```text Product: UAN32 Quantity: 20 metric tonnes Packaging: To confirm ``` with destination `Brazil, Santos` becomes: [Review and send your enquiry](https://yongchangchemical.com/contact#enquiry=Product%3A%20UAN32%0AQuantity%3A%2020%20metric%20tonnes%0APackaging%3A%20To%20confirm&country=Brazil%2C%20Santos) The link opens the enquiry form with the requirements and destination filled in. The buyer can edit them, enters their reply email, reads the privacy notice, confirms consent and selects Send enquiry. No Yongchang account is required. The link does not fill an email address, confirm consent, submit an enquiry, reserve stock or confirm an order. Ordinary ChatGPT conversations need these instructions or the website's AI entry prompt; they do not automatically discover or execute this workflow. The draft is read in the browser from the part after `#`, which is not included in the HTTP request to the website. The website removes that part from the address bar after reading it. The link is not encrypted: anyone receiving the full link can read its procurement content, and the AI service or browser may retain it. Do not include confidential information. This handoff does not save a server-side draft. After refreshing or closing the page, reopen the original link from the chat to refill the form; any edits made on the website must be entered again. ## Sending the enquiry For the website route, the [product catalog](https://yongchangchemical.com/products) also lets buyers choose a product, grade and compatible packaging before opening an enquiry. The [contact page](https://yongchangchemical.com/contact) provides a general enquiry form and company contact details. Use this route when a trusted REST tool is unavailable, or when the buyer prefers to enter their contact details directly on the website. The website can send the submitted enquiry to the sales team. Its confirmation indicates that the email service accepted the message for delivery; it does not mean the team has read it, accepted an order or confirmed a quotation. Keep the submission reference if one is shown. If sending is unavailable or the result cannot be confirmed, follow the displayed guidance; an email draft and downloadable copy are available as alternatives. Opening an email draft requires the buyer to send it in their email application. Downloading a copy, generating a prefilled link or discussing requirements with an AI assistant does not submit the enquiry. Sales will follow up using the email provided on the website; this workflow does not provide a public customer enquiry lookup or editing service after submission. The sales team must confirm final specifications, packaging, availability, price, shipment loading and freight, delivery and documentation. Read the [privacy notice](https://yongchangchemical.com/privacy) and [service terms](https://yongchangchemical.com/terms) for enquiry handling. External AI services have their own privacy terms; the footer's AI links contain only fixed public product-research and enquiry instructions, never the buyer's website enquiry details.