{"templateId":"markdown","sharedDataIds":{"sidebar":"sidebar-ai/sidebars.yaml"},"props":{"metadata":{"markdoc":{"tagList":[]},"type":"markdown","redocly_category":"Development","owner":"MB"},"seo":{"title":"AI - Norce Supplier MCP Tool Reference","description":"Reference for all tools exposed by the Norce Supplier MCP Server — supplier configuration, warehouses, locations, price lists, product imports, and setup validation.","keywords":"MCP, model context protocol, supplier MCP, supplier, warehouse, price list, import, tool reference"},"dynamicMarkdocComponents":[],"compilationErrors":[],"ast":{"$$mdtype":"Tag","name":"article","attributes":{},"children":[{"$$mdtype":"Tag","name":"Heading","attributes":{"level":1,"id":"norce-supplier-mcp--tool-reference"},"children":["Norce Supplier MCP — Tool Reference"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["This page documents the tools exposed by the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Norce Supplier MCP Server"]},". For setup and connection instructions, see ",{"$$mdtype":"Tag","name":"a","attributes":{"href":"/ai/using-the-norce-backend-mcp-servers"},"children":["Using the Norce Backend MCP Servers"]},"."]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["response_format"]}," parameter:"]}," Most tools accept a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["response_format"]}," parameter — either ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"markdown\""]}," (default, human-readable) or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"json\""]}," (for programmatic use). This parameter is not listed individually under each tool."]}]},{"$$mdtype":"Tag","name":"blockquote","attributes":{},"children":[{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["force_confirm"]}," parameter:"]}," Write tools include a ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["force_confirm"]}," parameter, backed by a server-side guard that classifies each operation by impact. Lower-impact operations go through, with a warning attached on stage and production. Higher-impact operations are blocked on ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["stage and production"]}," until ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["force_confirm"]}," is set. A few destructive operations are blocked on ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["every environment, including test"]},". Each tool below states which of these applies."]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"names-as-codes"},"children":["Names as codes"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A key convention in the Supplier MCP: the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["name"]}," field on warehouses and locations is also used as the code in Connect API imports and Query API lookups."]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Warehouse name"]}," = ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["WarehouseCode"]}," in Connect supplier imports"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Location name"]}," = ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["LocationCode"]}," in Connect supplier imports"]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Price list code"]}," = ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PriceListCode"]}," in Connect supplier imports"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Choose these values carefully when creating supplier infrastructure. Changing them after products have been imported will break existing stock and price update flows."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"tools"},"children":["Tools"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"list-suppliers"},"children":["List Suppliers"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["norce_supplier_list_suppliers"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Lists all suppliers with a summary view: ID, code, name, country, currency, active status, and whether chosen supplier logic is enabled."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Use this tool"]}," to find supplier IDs or codes before calling other tools, or to get an overview of which suppliers are configured for the client."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Parameters"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["applicationId"]}," — any valid application ID for the client."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["include_deleted"]}," — set to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["true"]}," to include soft-deleted suppliers. Useful when diagnosing a missing supplier."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Output"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A list of suppliers with their IDs, codes, names, country, currency, and status."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"get-supplier"},"children":["Get Supplier"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["norce_supplier_get_supplier"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Returns full configuration for a single supplier — including all warehouses with their locations, and all price lists with their warehouse connections."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Use this tool"]}," as the primary read tool for supplier data. It replaces what would otherwise require separate calls to list warehouses, list locations, list price lists, and get price list connections. Always call this before updating warehouse connections, location lists, or price list settings — the full-replace operations need the current state first."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Accepts either supplier ID or supplier code."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Parameters"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["applicationId"]}," — any valid application ID for the client."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["supplier_id"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["supplier_code"]}," — provide one, not both."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Output"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The full supplier record with all warehouses (each with their locations) and all price lists (each with their warehouse connections)."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"check-supplier-setup"},"children":["Check Supplier Setup"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["norce_supplier_check_supplier_setup"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Validates the full configuration chain for a supplier and returns a structured diagnostic report."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Use this tool"]}," before running a supplier product import to confirm the infrastructure is in place. A failing check will block imports or break availability calculations."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Checks performed"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Supplier exists and is active."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["At least one active warehouse exists."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Each warehouse has at least one location (required for Connect imports)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Each warehouse has a standard location (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["IsStandard = true"]},")."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["At least one active price list exists."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["At least one price list is marked primary (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["IsPrimary = true"]},")."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Each active price list is connected to at least one warehouse."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Parameters"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["applicationId"]}," — any valid application ID for the client."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["supplier_id"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["supplier_code"]}," — provide one, not both."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Output"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A diagnostic report with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["issues[]"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["warnings[]"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["passed[]"]},", and an ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["allOk"]}," boolean."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"img","attributes":{"src":"/assets/norce-supplier-check-supplier-setup-example.7c492653f927f168356a959004c9ee6e5caff4a340d1124340a4c42b03ec4d93.fe4eaf73.png","alt":"Example output from Check Supplier Setup showing diagnostic results"},"children":[]}]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"list-supplier-products"},"children":["List Supplier Products"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["norce_supplier_list_supplier_products"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Lists supplier product SKUs for a supplier from the Query API, with optional expansion to include prices and on-hand quantities."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Use this tool"]}," to verify which products are registered for a supplier, check product mappings (supplier part number to manufacturer part number), or audit stock and price data per supplier product. Supports pagination for large catalogues."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Note: the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["part_no"]}," field in supplier products is the ",{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["supplier's own part number"]}," — not the client SKU part number."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Parameters"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["applicationId"]}," — any valid application ID for the client."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["supplier_id"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["supplier_code"]}," — provide one, not both."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["part_nos"]}," — optional filter by one or more supplier part numbers."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["manufacturer_part_nos"]}," — optional filter by manufacturer part numbers."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["include_prices"]}," — set to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["true"]}," to include cost price and currency per price list."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["include_onhands"]}," — set to ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["true"]}," to include stock levels per warehouse and location."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["limit"]}," / ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["offset"]}," — pagination controls. Default 100 records, max 500 per call."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Output"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A list of supplier product SKUs with supplier part number, manufacturer info, category, EAN, active status, and (optionally) prices and on-hand quantities."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"import-supplier-products"},"children":["Import Supplier Products"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["norce_supplier_import_products"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Imports supplier product data — product identity, stock, prices, and parametric attributes — as an asynchronous batch job. Returns a job ID — use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["norce_supplier_get_import_job_status"]}," to confirm completion."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Use this tool"]}," when receiving a product feed from a supplier: new products, updated stock levels, updated cost prices, or updated product information."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The import header specifies which supplier, warehouse, and price list the records apply to. If warehouse or price list codes are omitted, the tool auto-resolves to the supplier's standard warehouse and primary price list."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Each record can include any combination of product identity, on-hand stock, price, and parametric attributes — include only what you have. The tool infers which fields are being set from what is present in the batch."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Parameters"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["applicationId"]}," — any valid application ID for the client."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["supplier_code"]}," — the supplier code (not the supplier name)."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["price_list_code"]}," — optional, defaults to the supplier's primary price list."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["warehouse_code"]}," — optional, defaults to the supplier's standard warehouse."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["location_code"]}," — optional, defaults to the standard location in the resolved warehouse."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["products"]}," — batch of supplier product records, minimum 1 and maximum 5000. Each record requires the supplier's own part number. All other fields (product name, manufacturer info, on-hand, price, parametric attributes) are optional."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["force_confirm"]}," — required on stage and production."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Output"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["A job ID for async status polling."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"get-import-job-status"},"children":["Get Import Job Status"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["norce_supplier_get_import_job_status"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Checks the status of an asynchronous supplier product import job."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Use this tool"]}," after ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["norce_supplier_import_products"]}," to confirm the import completed and check for errors. Poll until ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["IsFinished"]}," is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["true"]},"."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Parameters"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["applicationId"]}," — any valid application ID for the client."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["job_id"]}," — the job ID returned by ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["norce_supplier_import_products"]},"."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Output"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Job status, finish flag, and record counts (total, inserted, updated, failed)."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"create-supplier"},"children":["Create Supplier"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["norce_supplier_create_supplier"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Creates a new supplier record in Norce Commerce."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Use this tool"]}," when onboarding a new supplier. After creating the supplier, add at least one warehouse (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["norce_supplier_create_warehouse"]},") and one price list (",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["norce_supplier_create_price_list"]},") before running any imports."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Important:"]}," ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["is_chosen_supplier_enabled"]}," adds business logic to pricing and availability calculations. Only enable this if the supplier is intended to participate in chosen supplier rules — it has broader implications than a simple toggle."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Parameters"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["applicationId"]}," — any valid application ID for the client."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["name"]}," — display name."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["code"]}," — unique supplier code."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["country_id"]}," — country ID. Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["norce_config_get_client_overview"]}," to find country IDs."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["currency_id"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["currency_code"]}," — currency for this supplier."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["is_chosen_supplier_enabled"]}," — enable chosen supplier business logic. Default ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["false"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["force_confirm"]}," — not required. Creation proceeds with a warning on stage and production."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Output"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The created supplier ID."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"update-supplier"},"children":["Update Supplier"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["norce_supplier_update_supplier"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Updates settings on an existing supplier. Only the fields provided are changed. Accepts supplier ID or code."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Note: supplier code and currency cannot be changed after creation."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Parameters"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["applicationId"]}," — any valid application ID for the client."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["supplier_id"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["supplier_code"]}," — provide one, not both."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["name"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["is_active"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["is_chosen_supplier_enabled"]},", and chosen supplier charge settings — any combination."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["force_confirm"]}," — required on stage and production."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Output"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The updated supplier object."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"create-warehouse"},"children":["Create Warehouse"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["norce_supplier_create_warehouse"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Adds a new warehouse to a supplier."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Use this tool"]}," when setting up a new supplier or adding a warehouse to an existing one. After creating the warehouse, add at least one location using ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["norce_supplier_update_locations"]}," — imports will not work without a location."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Important:"]}," The warehouse name is used as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["WarehouseCode"]}," in Connect imports. Choose a stable, code-like name (for example ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"Standard\""]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["\"EU-WH\""]},"). Renaming after products have been imported will break stock update flows."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Parameters"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["applicationId"]}," — any valid application ID for the client."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["supplier_id"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["supplier_code"]}," — provide one, not both."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["name"]}," — warehouse name, also used as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["WarehouseCode"]}," in imports."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["standard_lead_time_days"]}," — default lead time for all products in this warehouse."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["is_standard"]}," — mark as the primary warehouse for this supplier. Only one can be standard."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ignore_stock"]}," — exclude from stock-based business logic. Use for display-only or transit warehouses."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["force_confirm"]}," — not required. Creation proceeds with a warning on stage and production."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Output"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The new warehouse ID."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"update-warehouse"},"children":["Update Warehouse"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["norce_supplier_update_warehouse"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Updates settings on an existing supplier warehouse. Only the fields provided are changed."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Important:"]}," Renaming the warehouse changes the ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["WarehouseCode"]}," used in Connect imports. Only do this if no products have been imported against this warehouse."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Parameters"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["applicationId"]}," — any valid application ID for the client."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["supplier_id"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["supplier_code"]}," — provide one, not both."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["warehouse_id"]}," — warehouse ID from ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["norce_supplier_get_supplier"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["name"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["standard_lead_time_days"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["is_standard"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["ignore_stock"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["is_active"]}," — any combination."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["force_confirm"]}," — not required. Updates proceed with a warning on stage and production."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Output"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The updated warehouse object."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"update-locations"},"children":["Update Locations"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["norce_supplier_update_locations"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Replaces the full list of locations for a supplier warehouse."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Use this tool"]}," to add, update, or reconfigure locations. This is also how you add the first location to a newly created warehouse."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Important:"]}," This is a full-replace operation — the list you provide becomes the complete set of locations for the warehouse. Always call ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["norce_supplier_get_supplier"]}," first to retrieve the current locations, then include all existing locations plus any changes or additions in your request."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Important:"]}," Location name is used as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["LocationCode"]}," in Connect imports. Renaming an existing location after products have been imported will break stock update flows."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Parameters"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["applicationId"]}," — any valid application ID for the client."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["supplier_id"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["supplier_code"]}," — provide one, not both."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["warehouse_id"]}," — warehouse ID from ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["norce_supplier_get_supplier"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["locations"]}," — the complete list of locations. Each entry requires a name and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["is_standard"]},". For existing locations include their ID; omit it for new ones. ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["standard_lead_time_days"]}," overrides the warehouse lead time when set."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["force_confirm"]}," — not required. The update proceeds with a warning on stage and production."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Output"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Confirmation of the update. Fetch the supplier again with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["norce_supplier_get_supplier"]}," to verify."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"create-price-list"},"children":["Create Price List"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["norce_supplier_create_price_list"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Adds a new price list to a supplier."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Use this tool"]}," when setting up a new supplier or adding a cost price list for a new currency or purpose. After creating the price list, connect it to a warehouse using ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["norce_supplier_update_price_list_warehouses"]}," — without this connection it will not function correctly in availability calculations."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Important:"]}," The price list code is used as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PriceListCode"]}," in Connect imports. Choose it carefully and do not change it after products have been imported against it."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Parameters"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["applicationId"]}," — any valid application ID for the client."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["supplier_id"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["supplier_code"]}," — provide one, not both."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["name"]}," — display name."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["code"]}," — unique code, also used as ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PriceListCode"]}," in imports."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["currency_id"]}," — currency for this price list."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["is_primary"]}," — mark as the primary price list. Only one price list per supplier should be primary."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["force_confirm"]}," — not required. Creation proceeds with a warning on stage and production."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Output"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The new price list ID."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"update-price-list"},"children":["Update Price List"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["norce_supplier_update_price_list"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Updates settings on an existing supplier price list. Only the fields provided are changed."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Important:"]}," Changing the price list code breaks Connect imports that reference the old ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["PriceListCode"]},". Only rename if no products have been imported against this price list."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Parameters"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["applicationId"]}," — any valid application ID for the client."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["supplier_id"]}," or ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["supplier_code"]}," — provide one, not both."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["price_list_id"]}," — price list ID from ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["norce_supplier_get_supplier"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["name"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["is_active"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["is_primary"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["is_manually_maintained"]},", ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["description"]}," — any combination."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["force_confirm"]}," — required on stage and production."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Output"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["The updated price list object."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"update-price-list-warehouse-connections"},"children":["Update Price List Warehouse Connections"]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["norce_supplier_update_price_list_warehouses"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Replaces the full list of warehouse connections for a supplier price list."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Use this tool"]}," after creating a price list to connect it to a warehouse, or to change which warehouses a price list is associated with. This connection determines which supplier stock is used for availability calculations when this price list is active."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Important:"]}," This is a full-replace operation. Always call ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["norce_supplier_get_supplier"]}," first to retrieve the current connections for the price list, then include all existing connections plus any new ones in your request."]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Parameters"]}]},{"$$mdtype":"Tag","name":"ul","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["applicationId"]}," — any valid application ID for the client."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["supplier_id"]}," — supplier ID."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["price_list_id"]}," — price list ID from ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["norce_supplier_get_supplier"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["connections"]}," — the complete list of warehouse connections. Each entry requires a warehouse ID. Location ID is optional but recommended for precise availability control."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":[{"$$mdtype":"Tag","name":"code","attributes":{},"children":["force_confirm"]}," — required on stage and production."]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":[{"$$mdtype":"Tag","name":"strong","attributes":{},"children":["Output"]}]},{"$$mdtype":"Tag","name":"p","attributes":{},"children":["Confirmation of the update."]},{"$$mdtype":"Tag","name":"hr","attributes":{},"children":[]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":2,"id":"typical-workflows"},"children":["Typical workflows"]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"setting-up-a-new-supplier-from-scratch"},"children":["Setting up a new supplier from scratch"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Call ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["norce_supplier_create_supplier"]}," with the supplier's name, code, country, and currency."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Call ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["norce_supplier_create_warehouse"]}," to add the first warehouse. Use a stable, code-like name."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Call ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["norce_supplier_update_locations"]}," to add at least one location to the warehouse. Mark one location as standard."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Call ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["norce_supplier_create_price_list"]}," to add the cost price list. Use a stable code."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Call ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["norce_supplier_update_price_list_warehouses"]}," to connect the price list to the warehouse."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Call ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["norce_supplier_check_supplier_setup"]}," to verify the full configuration is correct before importing."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"validating-a-supplier-before-importing"},"children":["Validating a supplier before importing"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Call ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["norce_supplier_check_supplier_setup"]}," to run the full validation chain."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If any checks fail, call ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["norce_supplier_get_supplier"]}," to inspect the current configuration and identify what is missing."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Fix each issue using the appropriate create or update tool."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Run ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["norce_supplier_check_supplier_setup"]}," again to confirm all checks pass."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"importing-a-supplier-product-feed"},"children":["Importing a supplier product feed"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Call ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["norce_supplier_check_supplier_setup"]}," to confirm the supplier infrastructure is in place."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Call ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["norce_supplier_get_supplier"]}," to get the warehouse and price list codes if they are not already known."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Prepare the batch — each record needs at minimum the supplier's own part number."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Call ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["norce_supplier_import_products"]}," with the full batch."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Poll ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["norce_supplier_get_import_job_status"]}," until ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["IsFinished"]}," is ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["true"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Spot-check a sample of records with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["norce_supplier_list_supplier_products"]}," to verify the data landed correctly."]}]},{"$$mdtype":"Tag","name":"Heading","attributes":{"level":3,"id":"auditing-supplier-product-mappings"},"children":["Auditing supplier product mappings"]},{"$$mdtype":"Tag","name":"ol","attributes":{},"children":[{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Call ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["norce_supplier_list_supplier_products"]}," with ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["include_prices = true"]}," and ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["include_onhands = true"]},"."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["Use ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["manufacturer_part_nos"]}," filtering to check whether specific client SKUs are mapped."]},{"$$mdtype":"Tag","name":"li","attributes":{},"children":["If mappings are missing or incorrect, update them via a new ",{"$$mdtype":"Tag","name":"code","attributes":{},"children":["norce_supplier_import_products"]}," call with the corrected manufacturer part numbers."]}]}]},"headings":[{"value":"Norce Supplier MCP — Tool Reference","id":"norce-supplier-mcp--tool-reference","depth":1},{"value":"Names as codes","id":"names-as-codes","depth":2},{"value":"Tools","id":"tools","depth":2},{"value":"List Suppliers","id":"list-suppliers","depth":3},{"value":"Get Supplier","id":"get-supplier","depth":3},{"value":"Check Supplier Setup","id":"check-supplier-setup","depth":3},{"value":"List Supplier Products","id":"list-supplier-products","depth":3},{"value":"Import Supplier Products","id":"import-supplier-products","depth":3},{"value":"Get Import Job Status","id":"get-import-job-status","depth":3},{"value":"Create Supplier","id":"create-supplier","depth":3},{"value":"Update Supplier","id":"update-supplier","depth":3},{"value":"Create Warehouse","id":"create-warehouse","depth":3},{"value":"Update Warehouse","id":"update-warehouse","depth":3},{"value":"Update Locations","id":"update-locations","depth":3},{"value":"Create Price List","id":"create-price-list","depth":3},{"value":"Update Price List","id":"update-price-list","depth":3},{"value":"Update Price List Warehouse Connections","id":"update-price-list-warehouse-connections","depth":3},{"value":"Typical workflows","id":"typical-workflows","depth":2},{"value":"Setting up a new supplier from scratch","id":"setting-up-a-new-supplier-from-scratch","depth":3},{"value":"Validating a supplier before importing","id":"validating-a-supplier-before-importing","depth":3},{"value":"Importing a supplier product feed","id":"importing-a-supplier-product-feed","depth":3},{"value":"Auditing supplier product mappings","id":"auditing-supplier-product-mappings","depth":3}],"frontmatter":{"seo":{"title":"AI - Norce Supplier MCP Tool Reference","description":"Reference for all tools exposed by the Norce Supplier MCP Server — supplier configuration, warehouses, locations, price lists, product imports, and setup validation.","keywords":"MCP, model context protocol, supplier MCP, supplier, warehouse, price list, import, tool reference"},"metadata":{"redocly_category":"Development","owner":"MB"}},"lastModified":"2026-09-16T06:55:22.000Z","pagePropGetterError":{"message":"","name":""}},"slug":"/ai/norce-supplier-mcp-tool-reference","userData":{"isAuthenticated":false,"teams":["anonymous"]}}