Magento 2.2.0：如何通过REST API不创建购物车直接创建订单？

我之前也碰到过一模一样的问题——从Magento 1迁移数据到2.2.0版本时，客户和产品数据都能正常迁移，唯独直接创建订单时触发了Call to a member function getMethodInstance() on null的致命错误。后来排查下来，问题全出在数据结构的细节错误上，尤其是支付和配送部分的格式不符合Magento API的预期。

错误原因分析 #

这个错误来自SalesOrderBeforeSaveObserver，本质是Magento无法找到你指定的支付/配送方式对应的实例，大概率是以下几个原因导致的：

• 支付方式代码写错，或者该方式在后台未启用
• 配送信息的结构错误（比如你最初把shipping.address写成了数组，而API期望是单个对象）
• 订单总计相关字段不匹配（比如amount_paid和grand_total数值不一致）

关键修正要点 #

你提到已经用调整后的JSON成功创建了订单，我整理几个核心注意点，帮其他遇到同样问题的开发者避坑：

• 支付方式必须合法：payment.method要使用Magento后台已启用的支付方式代码（比如checkmo是支票支付，要确保在Stores > Configuration > Sales > Payment Methods中开启）
• 配送地址格式正确：extension_attributes.shipping_assignments.shipping.address应该是单个对象，而不是数组（你最初的示例里写成了[{...}]，这是常见的错误点）
• 商品项是数组格式：entity.items和shipping_assignments.items都需要是数组，哪怕只有一个商品，M2 API不接受单个对象格式
• 金额字段要匹配：base_grand_total、grand_total、payment.amount_paid这几个金额数值必须保持一致，小计、税费、运费的总和要等于订单总计

修正后的完整JSON示例 #

这里是调整后的正确请求JSON（和你成功的版本对齐，修正了结构细节）：

{
  "entity": {
    "customer_email": "provacustomer@mail.com",
    "customer_firstname": "mario",
    "customer_lastname": "rossi",
    "base_grand_total": 120,
    "discount_amount": 0,
    "grand_total": 120,
    "increment_id": "200001414155",
    "shipping_amount": 7,
    "status": "processing",
    "store_id": 1,
    "subtotal": 100,
    "tax_amount": 20,
    "items": [
      {
        "description": "prodotto mio",
        "item_id": 3,
        "price": 10,
        "product_id": 3,
        "product_type": "simple",
        "qty_ordered": 2,
        "sku": "002",
        "tax_amount": 2,
        "weight": 1
      }
    ]
  },
  "billing_address": {
    "firstname": "giuseppa",
    "lastname": "rossi",
    "company": "mycompany",
    "city": "rome",
    "region": "california",
    "region_id": 12,
    "postcode": "12312",
    "telephone": "1234556677",
    "country_id": "US",
    "street": ["via prima", "via seconda"]
  },
  "payment": {
    "amount_paid": 120,
    "method": "checkmo"
  },
  "status_histories": [
    {
      "comment": "new order",
      "status": "processing"
    }
  ],
  "extension_attributes": {
    "shipping_assignments": [
      {
        "shipping": {
          "address": {
            "firstname": "franca",
            "lastname": "vardididi",
            "company": "mycompany",
            "city": "rome",
            "region": "california",
            "region_id": 12,
            "postcode": "12312",
            "telephone": "1234556677",
            "country_id": "US",
            "street": ["via prima", "via seconda"]
          },
          "method": "checkmo",
          "total": {
            "base_shipping_amount": 7
          }
        },
        "items": [
          {
            "description": "prodotto mio",
            "item_id": 3,
            "price": 10,
            "product_id": 3,
            "product_type": "simple",
            "qty_ordered": 2,
            "sku": "002",
            "tax_amount": 2,
            "weight": 1
          }
        ]
      }
    ]
  }
}

总结 #

直接通过REST API创建订单完全不需要先创建购物车，只要确保所有字段的格式和值严格符合Magento 2.2.0的API规范，尤其是支付、配送和商品项的结构细节，就能避开这类致命错误。

内容的提问来源于stack exchange，提问作者sissy