Ginbing

Start a new trademark application draft in the connected Ginbing account. Reuse the same creationKey when retrying; the existing draft is returned. The customer completes and submits the application on the Ginbing website.

Read a draft with the fields still missing (missingFields, which you can fill with update_filing_draft) and the steps the customer completes on the Ginbing website (customerWebsiteSteps). Identity document numbers and documents stay on the website. When aiPreparationComplete is true, give the customer those steps and accountUrl.

List the trademark application drafts in the connected Ginbing account, newest first.

Use this to find goods and services for a China trademark filing by keyword, in English or Chinese, optionally within one class. Items come from the current list of CNIPA (China National Intellectual Property Administration), maintained by Ginbing. labelZh is the exact Chinese text filed with CNIPA, and label is the English name CNIPA gives it. standardItem is true for standard items from the Nice Classification or the Chinese national list, and false for other items on the CNIPA list. itemCode is the CNIPA item number when there is one; groupCode, groupLabel and groupLabelZh identify the similarity group within the class. itemId, and selectionToken when a Ginbing account is connected, are for other Ginbing tools. Equally relevant standard items come first; if only non-standard items match, a broader term may find a standard one. Refine the query when hasMore is true. Results are lookup data, not legal advice.

Patch permitted fields of your draft using its expectedRevision. Omitted fields are preserved; null clears permitted text fields. Add goods/services with account-bound selection tokens from search_taxonomy, remove existing item IDs. Never supply external labels/classes or identity numbers. Outdated items require a new search. The typed signature prepares the filing authorization; the customer still reviews and submits on the website.

Use this to check that goods or services picked earlier are still on the current CNIPA list. Pass each itemId. To also check a saved filing, add previousFiling with the classNumber, groupCode, groupLabelZh, itemCode, labelZh and standardItem received for that item. status is current; needs_reselection when the Chinese filing details changed, so search again; stale when a saved item left the list; or missing for an unknown itemId. Similar items are never substituted. English-only changes do not affect the filing.