Responses

• 201 application/json

  申报创建成功

  Hide response attributes Show response attributes object

  • id integer(int64)
  • reference string

    系统生成的申报号

  • client_ref string Required

    客户参考号 (8-32 位，仅包含字母、数字、连字符和下划线)

    Minimum length is 8, maximum length is 32. Format should match the following pattern: ^[A-Z0-9\-_]+$.

  • lrn string

    申报参考号 (8-32 位，仅包含字母、数字、连字符和下划线)

    注意: 目前系统都支持自定义，但不保证未来所有系统都支持

    Minimum length is 8, maximum length is 32. Format should match the following pattern: ^[A-Z0-9\-_]+$.

  • mrn string

    参考号（海关返回）

  • template_code string Required

    申报模板代码 (8-32 位，仅包含字母、数字、连字符和下划线)

    Minimum length is 8, maximum length is 32. Format should match the following pattern: ^[A-Z0-9\-_]+$.

  • declaration_type string Required

    申报类型 (IM=进口，EX=出口)

    Values are IM or EX.

  • additional_declaration_type string Required

    附加申报类型 (A=标准申报，D=预申报)

    Values are A or D.

  • presentation_mode string

    呈报（确认）模式 (conditional, scheduled)

  • provisional_validation_datetime string(date-time)

    暂定确认时间（预申报场景）

  • declaration_office_code string Required

    申报办公室代码 https://www.tariffnumber.com/offices

  • presentation_office_code string

    呈报办公室代码

  • shipment_carrier_ref string

    承运人参考号

  • mode_at_border string

    边境运输方式

    Values are sea, rail, road, air, or post.

  • inland_mode string

    内陆运输方式

  • country_of_dispatch_code string Required

    出口国代码 (ISO3166 alpha2 代码)

    Minimum length is 2, maximum length is 2. Format should match the following pattern: ^[A-Z]{2}$.

  • country_of_destination_code string Required

    进口国代码 (ISO3166 alpha2 代码)

    Minimum length is 2, maximum length is 2. Format should match the following pattern: ^[A-Z]{2}$.

  • gross_weight_in_kg number(float) Required

    总毛重（千克，必须大于 0）

    Minimum value is 0.001.

  • total_packages integer Required

    总包装数（必须大于 0）

    Minimum value is 1. Default value is 1.

  • unique_consignment_reference string

    唯一托运参考号

  • location_of_goods_code string

    货物位置代码 (3 位 IATA 机场代码或 UN/LOCODE 格式) https://datahub.io/core/un-locode

    Format should match the following pattern: ^([A-Z]{3}|[A-Z]{2}[A-Z0-9]{3,})$.

  • location_of_goods_type string

    货物位置类型

  • location_of_goods object

    货物位置详情

    Hide location_of_goods attributes Show location_of_goods attributes object

    • country_code string
    • postal_code string
    • street_number string
    • city string
    • street_name string
  • delivery_terms string

    交货条款 https://www.trade.gov/know-your-incoterms

    Values are EXW, FCA, CPT, CIP, DAP, DPU, DDP, DDU, FAS, FOB, CFR, or CIF.

  • delivery_terms_location string

    交货条款地点

  • currency_code string Required

    货币代码 (ISO4217 三字母代码) https://www.iban.com/currency-codes

    Format should match the following pattern: ^[A-Z]{3}$. Default value is EUR.

  • currency_exchange_rate number(float)

    汇率

  • ioss_number string

    IOSS 号码 (10-16 位，仅包含字母、数字和连字符)

    Minimum length is 10, maximum length is 16. Format should match the following pattern: ^[A-Z0-9\-]+$.

  • deferred_payment_account string

    延期付款账户

  • status string

    申报状态。注意：一旦提交到海关，状态将不可逆地改变

    Values are pending, submitted, acknowledged, under_review, additional_info_required, customs_control, accepted, released, rejected, confiscated, suspended, cancelling, cancelled, archived, or exception.

  • reject_reason string

    拒绝原因

  • importer object
    Hide importer attributes Show importer attributes object

    • id integer(int64)
    • name string Required
    • attention_to string
    • street_address string Required
    • city string Required
    • state string
    • postal_code string Required
    • country_code string Required

      ISO3166 alpha2 code

    • email string
    • phone string
    • eori_number string
    • vat_number string
    • tax_id string
  • exporter object
    Hide exporter attributes Show exporter attributes object

    • id integer(int64)
    • name string Required
    • attention_to string
    • street_address string Required
    • city string Required
    • state string
    • postal_code string Required
    • country_code string Required

      ISO3166 alpha2 code

    • email string
    • phone string
    • eori_number string
    • vat_number string
    • tax_id string
  • declarant object
    Hide declarant attributes Show declarant attributes object

    • id integer(int64)
    • name string Required
    • attention_to string
    • street_address string Required
    • city string Required
    • state string
    • postal_code string Required
    • country_code string Required

      ISO3166 alpha2 code

    • email string
    • phone string
    • eori_number string
    • vat_number string
    • tax_id string
  • representative object
    Hide representative attributes Show representative attributes object

    • id integer(int64)
    • name string Required
    • attention_to string
    • street_address string Required
    • city string Required
    • state string
    • postal_code string Required
    • country_code string Required

      ISO3166 alpha2 code

    • email string
    • phone string
    • eori_number string
    • vat_number string
    • tax_id string
  • documents array[object]

    相关文档

    Hide documents attributes Show documents attributes object

    • id integer(int64)
    • category string

      文档类别

      Values are transport, commercial, or other.

    • type_code string Required

      文档类型代码 N380=Invoice, N740=Air Waybill

    • reference_number string Required

      参考号码

    • valid_from string(date-time) Required

      有效期开始时间

    • file_url string(uri)

      文件 URL

  • items array[object]

    商品明细 (1-999 个商品)

    At least 1 but not more than 999 elements.

    Hide items attributes Show items attributes object

    • id integer(int64)
    • description string Required

      商品描述

    • commodity_code string Required

      商品编码

      Minimum length is 6, maximum length is 12.

    • national_additional_codes array[string]

      国家附加代码

    • requested_procedure string

      请求程序

    • additional_procedure_codes array[string]

      附加程序代码

    • currency_code string Required

      货币代码 (ISO4217 三字母代码)

      Format should match the following pattern: ^[A-Z]{3}$. Default value is EUR.

    • intrinsic_value decimal Required

      内在价值总价（该商品的总价值，非单价）

    • freight_cost integer

      运费总价（该商品的总运费，非单价）

    • insurance_cost integer

      保险费总价（该商品的总保险费，非单价）

    • gross_weight_in_grams integer Required

      毛重总重（克，该商品的总毛重，非单件重量）

    • net_weight_in_grams integer Required

      净重总重（克，该商品的总净重，非单件重量）

    • gross_weight_in_kg number(float)

      毛重总重（千克，该商品的总毛重，非单件重量）

    • net_weight_in_kg number(float)

      净重总重（千克，该商品的总净重，非单件重量）

    • package_type string

      包装类型

    • number_of_packages integer

      包装数量

      Default value is 1.

    • shipping_marks string

      运输标记

    • quantity integer Required

      数量

    • supplementary_units string

      补充单位

    • supplementary_units_amount integer

      补充单位数量

    • country_of_origin string Required

      原产国

    • dangerous_goods_code string

      危险品代码

    • ecommerce_ref string

      电商参考号

    • ecommerce_url string(uri)

      电商 URL

    • documents array[object]

      相关文档

      Hide documents attributes Show documents attributes object

      • id integer(int64)
      • category string

        文档类别

        Values are transport, commercial, or other.

      • type_code string Required

        文档类型代码 N380=Invoice, N740=Air Waybill

      • reference_number string Required

        参考号码

      • valid_from string(date-time) Required

        有效期开始时间

      • file_url string(uri)

        文件 URL

    • tax_lines array[object]

      税金明细

      Hide tax_lines attributes Show tax_lines attributes object

      • id integer(int64)

        税金行 ID

      • type_code string Required

        税金类型代码

      • category string Required

        税金类别

        Values are duty or vat.

      • regime_code string

        制度代码

      • rate number(float) Required

        税率

      • currency string Required

        货币代码

      • base_amount number(float)

        计税基础金额

      • deduct_amount number(float)

        扣除金额

      • amount number(float) Required

        税金金额

      • created_at string(date-time)

        创建时间

      • updated_at string(date-time)

        更新时间

  • tax_lines array[object]

    税金明细

    Hide tax_lines attributes Show tax_lines attributes object

    • id integer(int64)

      税金行 ID

    • type_code string Required

      税金类型代码

    • category string Required

      税金类别

      Values are duty or vat.

    • regime_code string

      制度代码

    • rate number(float) Required

      税率

    • currency string Required

      货币代码

    • base_amount number(float)

      计税基础金额

    • deduct_amount number(float)

      扣除金额

    • amount number(float) Required

      税金金额

    • created_at string(date-time)

      创建时间

    • updated_at string(date-time)

      更新时间

  • tax_assessment_notice_url string

    PDF 税单链接

  • created_at string(date-time)

    创建时间

  • updated_at string(date-time)

    更新时间

  • scheduled_at string(date-time)

    计划时间

  • submitted_at string(date-time)

    提交时间

  • accepted_at string(date-time)

    接受时间

  • inspected_at string(date-time)

    查验时间

  • finalized_at string(date-time)

    完结时间

  • released_at string(date-time)

    放行时间

  • cancelled_at string(date-time)

    取消时间

  • goods_presentation_due_date string(date)

    货物呈报截止日期

  • goods_presentation_effective_date string(date-time)

    货物呈报生效日期

  • cancellation_requested_at string(date-time)

    取消请求时间

  • rejected_at string(date-time)

    拒绝时间

• 400 application/json

  请求参数错误

  Hide response attributes Show response attributes object

  • error string
  • errors object
    Hide errors attribute Show errors attribute object

    • * array[string] Additional properties
• 401

  未授权

• 422 application/json

  验证失败

  Hide response attributes Show response attributes object

  • error string
  • errors object
    Hide errors attribute Show errors attribute object

    • * array[string] Additional properties