Best Practices

The following is a list of best practices for JOOR's Brand API. We recommend implementing these functional and technical capabilities while building your API integration with JOOR for the best possible user experience.

General

  1. Provide singular technical point of contact for integration-related work, issues, and troubleshooting.
  2. Provide the ability to test the integrations using JOOR’s Sandbox Account.
  3. Send JOOR the header (including endpoint URI) and body (XML/JSON) details of specific API requests to help troubleshoot issues.
  4. Provide interface with integration settings on the ERP accessible by the brand.
  5. Process and display REST API responses to users to allow for troubleshooting errors.
  6. Provide training to brand on ERP integration process with JOOR.
  7. Trigger all integrations automatically via a set schedule and manually on demand.
  8. Ability to store multiple API tokens, if account is split to multiple JOOR profiles -- usually per division or company.

Styles

  1. Create, update, and delete styles.
  2. Support multiple price types and currencies for wholesale and retail prices.
  3. Deactivate sizes.
  4. Delete colors.
  5. Split styles in JOOR by brand’s desired method (i.e. colors, fabrication, silhouette, etc.).
  6. Create and assign custom style fields (style tags).
  7. Send JOOR Categories when creating styles.
  8. Send casepack sizes. Note: Casepacks need to be setup in JOOR before sending.
  9. Use standard ISO 3-character currency codes.
  10. Send the same price type currencies and labels for styles and customers.
  11. Allow users to manually create linesheets in JOOR (using the delivery_overwrite field).
  12. Create linesheets in JOOR based on brand’s criteria (season, delivery, etc.).
  13. Exclude colors from linesheets per season.
  14. Drop styles from linesheets.

Inventory

  1. Load inventory using Color, Size, and Style ID or Style Identifier if splitting styles by data other than Style Number.
  2. Provide option for brand to send all inventory (Overwrite) or updates only (Update).
  3. Support multiple warehouses and availability dates (Immediate and future).
  4. Send inventory for casepack sizes.

Images

  1. Send images as non-password protected URLs.
  2. Send style, color, and swatch images to JOOR as desired by brand.

Connections

  1. Utilize the Bulk Connections endpoint to create and update customers.
  2. Create Doors based on shipping addresses.
  3. Assign Discounts at the Order or Item level.
  4. Assign warehouses to customers.
  5. Assign Sales Reps to customers.
  6. Use standard ISO 3-character currency codes.
  7. Send the same price type currencies and labels for styles and customers.

Orders

  1. Import orders from JOOR, perform a valid import to ERP, and mark the order as “Exported” in JOOR using sync=1 parameter.
  2. Store JOOR’s Order ID for reference in the ERP.
  3. Import the same order more than once to overwrite data in ERP.
  4. Import all style, customer, and order data from JOOR.
  5. Import Order and Line Item level discounts.