Shop Duty Desk

{'type': 'object', 'required': ['products'], 'properties': {'markets': {'type': 'array', 'items': {'enum': ['UK', 'US'], 'type': 'string'}, 'maxItems': 2, 'minItems': 1, 'description': 'Tariff schedules to search (default UK). Searching both uses more of the per-call request allowance, so large lists may be cut short.'}, 'products': {'type': 'array', 'items': {'type': 'object', 'required': ['title'], 'properties': {'title': {'type': 'string', 'description': 'Product name, such as "women\'s cotton t-shirt"'}, 'description': {'type': 'string', 'description': 'A line about what it is made of or used for (used when the title finds nothing)'}}, 'additionalProperties': False}, 'maxItems': 20, 'minItems': 1, 'description': 'Products to find candidate tariff codes for, at most 20.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['status', 'results', 'sources', 'notice'], 'properties': {'notice': {'type': 'string'}, 'status': {'type': 'string', 'description': 'Every code below is a candidate, not binding.'}, 'results': {'type': 'array', 'items': {'type': 'object', 'required': ['title', 'candidates'], 'properties': {'note': {'type': 'string'}, 'title': {'type': 'string'}, 'candidates': {'type': 'array', 'items': {'type': 'object', 'required': ['code', 'description', 'source', 'status'], 'properties': {'code': {'type': 'string'}, 'source': {'type': 'string'}, 'status': {'type': 'string'}, 'description': {'type': 'string'}}}}}}}, 'sources': {'type': 'array', 'items': {'type': 'string'}}}}

{'type': 'object', 'required': ['csv'], 'properties': {'csv': {'type': 'string', 'maxLength': 2000000, 'minLength': 1, 'description': 'The CSV text exactly as exported from Shopify, header row included. At most 2 MB.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['summary', 'issues', 'truncated', 'notes'], 'properties': {'notes': {'type': 'array', 'items': {'type': 'string'}}, 'issues': {'type': 'array', 'items': {'type': 'object', 'required': ['row', 'problem'], 'properties': {'row': {'type': 'integer'}, 'handle': {'type': 'string'}, 'problem': {'type': 'string'}}}}, 'summary': {'type': 'object', 'required': ['rows'], 'properties': {'rows': {'type': 'integer'}, 'bad_hs': {'type': ['integer', 'null']}, 'bad_gtin': {'type': ['integer', 'null']}, 'bad_origin': {'type': ['integer', 'null']}, 'missing_hs': {'type': ['integer', 'null']}, 'missing_origin': {'type': ['integer', 'null']}, 'missing_identifier': {'type': ['integer', 'null']}}, 'description': 'A count is null when the file has no column to check it with.'}, 'truncated': {'type': 'boolean'}}}

{'type': 'object', 'required': ['lines', 'channel'], 'properties': {'date': {'type': 'string', 'pattern': '^\\d{4}-\\d{2}-\\d{2}$', 'description': 'Import day, YYYY-MM-DD (default today, UTC)'}, 'lines': {'type': 'array', 'items': {'type': 'object', 'required': ['description', 'origin', 'qty', 'unit_value_eur'], 'properties': {'qty': {'type': 'integer', 'minimum': 1, 'description': 'Units on the line'}, 'origin': {'type': 'string', 'description': '2-letter country the goods were made in, such as CN'}, 'hs_code': {'type': 'string', 'description': '6, 8 or 10 digit tariff code, if known (a candidate, not binding)'}, 'description': {'type': 'string', 'description': 'What the goods are, such as "cotton t-shirt"'}, 'unit_value_eur': {'type': 'number', 'minimum': 0, 'description': 'Price of one unit in euros'}}, 'additionalProperties': False}, 'maxItems': 200, 'minItems': 1, 'description': 'Order lines of one consignment. Each line holds only description, hs_code (optional), origin, qty and unit_value_eur; lines with any other field, such as a customer name or address, are refused.'}, 'channel': {'enum': ['ioss', 'postal'], 'type': 'string', 'description': 'ioss: the import is VAT-exempt under the Import One-Stop Shop. postal: the goods travel in a postal consignment.'}, 'consignment_value_eur': {'type': 'number', 'minimum': 0, 'description': 'Intrinsic value of the whole consignment in euros, if different from the sum of the lines'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['legal_basis', 'consignments', 'total_duty_eur', 'assumptions'], 'properties': {'assumptions': {'type': 'array', 'items': {'type': 'string'}}, 'legal_basis': {'type': 'array', 'items': {'type': 'object', 'properties': {'url': {'type': 'string'}, 'use': {'type': 'string'}, 'instrument': {'type': 'string'}}}}, 'consignments': {'type': 'array', 'items': {'type': 'object', 'required': ['items', 'duty_eur'], 'properties': {'note': {'type': 'string'}, 'items': {'type': 'integer'}, 'duty_eur': {'type': ['number', 'null']}, 'value_eur': {'type': 'number'}, 'exempt_reason': {'type': 'string'}, 'items_if_identical_lines_grouped': {'type': 'integer'}, 'duty_if_identical_lines_grouped_eur': {'type': ['number', 'null']}}}}, 'total_duty_eur': {'type': 'number'}}}

{'type': 'object', 'required': ['ticket'], 'properties': {'ticket': {'type': 'string', 'pattern': '^fb_[0-9a-f]{32}$', 'description': 'The ticket id that submit_feedback returned.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['ticket', 'status'], 'properties': {'note': {'type': 'string'}, 'reply': {'type': ['string', 'null']}, 'status': {'enum': ['pending', 'answered'], 'type': 'string'}, 'ticket': {'type': 'string'}}}

{'type': 'object', 'properties': {'task': {'type': 'string', 'description': 'Alias for query: task phrase to search.'}, 'query': {'type': 'string', 'description': "Optional task keyword or phrase to search tools (e.g. 'recruiter', 'linkedin', 'feedback', 'broken links', 'jobs'). Omit to list all tools."}, 'keyword': {'type': 'string', 'description': 'Alias for query: keyword to search.'}}, 'additionalProperties': True}

{'type': 'object', 'required': ['hs_code', 'destination', 'goods_value', 'shipping'], 'properties': {'origin': {'type': 'string', 'pattern': '^[A-Za-z]{2}$', 'description': '2-letter country the goods come from (optional)'}, 'country': {'type': 'string', 'pattern': '^[A-Za-z]{2}$', 'description': 'EU member state for the VAT rate, such as DE (EU destination)'}, 'hs_code': {'type': 'string', 'maxLength': 16, 'minLength': 6, 'description': 'A full tariff line (UK 10 digits, US 8 or 10 digits), a candidate, not binding. EU rates are not looked up.'}, 'shipping': {'type': 'number', 'minimum': 0, 'description': 'Shipping and insurance to the destination, in the same currency'}, 'destination': {'enum': ['UK', 'US', 'EU'], 'type': 'string'}, 'goods_value': {'type': 'number', 'minimum': 0, 'description': 'Value of the goods, in the one currency used for every amount (no conversion is done)'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['hs_code', 'hs_status', 'destination', 'duty', 'vat', 'total', 'complete', 'sources', 'as_of', 'notes'], 'properties': {'vat': {'type': 'object', 'required': ['amount'], 'properties': {'amount': {'type': ['number', 'null']}, 'source': {'type': ['string', 'null']}, 'rate_pct': {'type': ['number', 'null']}}}, 'duty': {'type': 'object', 'required': ['amount', 'basis'], 'properties': {'rate': {'type': ['string', 'null']}, 'basis': {'type': 'string'}, 'amount': {'type': ['number', 'null']}, 'rate_pct': {'type': ['number', 'null']}}}, 'as_of': {'type': 'string'}, 'notes': {'type': 'array', 'items': {'type': 'string'}}, 'total': {'type': 'number'}, 'hs_code': {'type': 'string'}, 'sources': {'type': 'array', 'items': {'type': 'string'}}, 'complete': {'type': 'boolean'}, 'shipping': {'type': 'number'}, 'hs_status': {'type': 'string'}, 'destination': {'type': 'string'}, 'goods_value': {'type': 'number'}}}

{'type': 'object', 'required': ['kind', 'message'], 'properties': {'kind': {'enum': ['need_tool', 'need_data', 'bug', 'other'], 'type': 'string', 'description': 'need_tool: a tool you want. need_data: data a tool lacks. bug: something broke. other: anything else about the tools.'}, 'tool': {'type': 'string', 'pattern': '^[A-Za-z0-9_.:-]{1,64}$', 'description': 'Optional: the name of the tool this is about, for example find_tariff_codes.'}, 'message': {'type': 'string', 'maxLength': 1000, 'minLength': 10, 'description': 'What you need or what broke, in plain words, at most 1000 characters. Links, email addresses and phone numbers are removed. Never include secrets or personal details.'}}, 'additionalProperties': False}

{'type': 'object', 'required': ['ticket', 'status'], 'properties': {'note': {'type': 'string'}, 'reply': {'type': ['string', 'null']}, 'status': {'enum': ['pending', 'answered'], 'type': 'string'}, 'ticket': {'type': 'string'}}}