Post v1 order order id invoice

POST /V1/order/{orderId}/invoice

Path parameters

orderId integer Required

Body

capture boolean
items array[object]
Hide items attributes Show items attributes object
Input argument for invoice creation Interface InvoiceItemCreationInterface
- extension_attributes object
  
  ExtensionInterface class for @see \Magento\Sales\Api\Data\InvoiceItemCreationInterface
- order_item_id integer Required
  
  Order item ID.
- qty number Required
  
  Quantity.
notify boolean
appendComment boolean
comment object

Interface InvoiceCommentCreationInterface
Hide comment attributes Show comment attributes object
- extension_attributes object
  
  ExtensionInterface class for @see \Magento\Sales\Api\Data\InvoiceCommentCreationInterface
- comment string Required
  
  Comment.
- is_visible_on_front integer Required
  
  Is-visible-on-storefront flag value.
arguments object

Interface for creation arguments for Invoice.
Hide arguments attribute Show arguments attribute object
- extension_attributes object
  
  ExtensionInterface class for @see \Magento\Sales\Api\Data\InvoiceCreationArgumentsInterface

Body

capture boolean
items array[object]
Hide items attributes Show items attributes object
Input argument for invoice creation Interface InvoiceItemCreationInterface
- extension_attributes object
  
  ExtensionInterface class for @see \Magento\Sales\Api\Data\InvoiceItemCreationInterface
- order_item_id integer Required
  
  Order item ID.
- qty number Required
  
  Quantity.
notify boolean
appendComment boolean
comment object

Interface InvoiceCommentCreationInterface
Hide comment attributes Show comment attributes object
- extension_attributes object
  
  ExtensionInterface class for @see \Magento\Sales\Api\Data\InvoiceCommentCreationInterface
- comment string Required
  
  Comment.
- is_visible_on_front integer Required
  
  Is-visible-on-storefront flag value.
arguments object

Interface for creation arguments for Invoice.
Hide arguments attribute Show arguments attribute object
- extension_attributes object
  
  ExtensionInterface class for @see \Magento\Sales\Api\Data\InvoiceCreationArgumentsInterface

Responses

200

application/json

application/json application/xml

200 Success.
401

application/json

application/json application/xml

401 Unauthorized
Hide response attributes Show response attributes object
- message string Required
  
  Error message
- errors array[object]
  
  Errors list
  
  Hide errors attributes Show errors attributes object
  
  Error details
  
  message string
  
  Error message
  
  parameters array[object]
  
  Error parameters list
  
  Hide parameters attributes Show parameters attributes object
  
  Error parameters item
  
  resources string
  
  ACL resource
  
  fieldName string
  
  Missing or invalid field name
  
  fieldValue string
  
  Incorrect field value
- code integer
  
  Error code
- parameters array[object]
  
  Error parameters list
  
  Hide parameters attributes Show parameters attributes object
  
  Error parameters item
  
  resources string
  
  ACL resource
  
  fieldName string
  
  Missing or invalid field name
  
  fieldValue string
  
  Incorrect field value
- trace string
  
  Stack trace
Hide response attributes Show response attributes object
- message string Required
  
  Error message
- errors array[object]
  
  Errors list
  
  Hide errors attributes Show errors attributes object
  
  Error details
  
  message string
  
  Error message
  
  parameters array[object]
  
  Error parameters list
  
  Hide parameters attributes Show parameters attributes object
  
  Error parameters item
  
  resources string
  
  ACL resource
  
  fieldName string
  
  Missing or invalid field name
  
  fieldValue string
  
  Incorrect field value
- code integer
  
  Error code
- parameters array[object]
  
  Error parameters list
  
  Hide parameters attributes Show parameters attributes object
  
  Error parameters item
  
  resources string
  
  ACL resource
  
  fieldName string
  
  Missing or invalid field name
  
  fieldValue string
  
  Incorrect field value
- trace string
  
  Stack trace
default

application/json

application/json application/xml

Unexpected error
Hide response attributes Show response attributes object
- message string Required
  
  Error message
- errors array[object]
  
  Errors list
  
  Hide errors attributes Show errors attributes object
  
  Error details
  
  message string
  
  Error message
  
  parameters array[object]
  
  Error parameters list
  
  Hide parameters attributes Show parameters attributes object
  
  Error parameters item
  
  resources string
  
  ACL resource
  
  fieldName string
  
  Missing or invalid field name
  
  fieldValue string
  
  Incorrect field value
- code integer
  
  Error code
- parameters array[object]
  
  Error parameters list
  
  Hide parameters attributes Show parameters attributes object
  
  Error parameters item
  
  resources string
  
  ACL resource
  
  fieldName string
  
  Missing or invalid field name
  
  fieldValue string
  
  Incorrect field value
- trace string
  
  Stack trace
Hide response attributes Show response attributes object
- message string Required
  
  Error message
- errors array[object]
  
  Errors list
  
  Hide errors attributes Show errors attributes object
  
  Error details
  
  message string
  
  Error message
  
  parameters array[object]
  
  Error parameters list
  
  Hide parameters attributes Show parameters attributes object
  
  Error parameters item
  
  resources string
  
  ACL resource
  
  fieldName string
  
  Missing or invalid field name
  
  fieldValue string
  
  Incorrect field value
- code integer
  
  Error code
- parameters array[object]
  
  Error parameters list
  
  Hide parameters attributes Show parameters attributes object
  
  Error parameters item
  
  resources string
  
  ACL resource
  
  fieldName string
  
  Missing or invalid field name
  
  fieldValue string
  
  Incorrect field value
- trace string
  
  Stack trace

POST /V1/order/{orderId}/invoice

curl \
 --request POST 'https://magento2.winkelstraat.mac/rest/all/V1/order/{orderId}/invoice' \
 --header "Content-Type: application/json" \
 --data '{"capture":true,"items":[{"extension_attributes":{},"order_item_id":42,"qty":42.0}],"notify":true,"appendComment":true,"comment":{"extension_attributes":{},"comment":"string","is_visible_on_front":42},"arguments":{"extension_attributes":{}}}'

curl \
 --request POST 'https://magento2.winkelstraat.mac/rest/all/V1/order/{orderId}/invoice' \
 --header "Content-Type: application/xml"

Request examples

{
  "capture": true,
  "items": [
    {
      "extension_attributes": {},
      "order_item_id": 42,
      "qty": 42.0
    }
  ],
  "notify": true,
  "appendComment": true,
  "comment": {
    "extension_attributes": {},
    "comment": "string",
    "is_visible_on_front": 42
  },
  "arguments": {
    "extension_attributes": {}
  }
}

Request examples

<?xml version="1.0" encoding="UTF-8"?>
<root>
  <capture type="boolean">true</capture>
  <items type="array">
    <item>
      <extension-attributes>
      </extension-attributes>
      <order-item-id type="integer">42</order-item-id>
      <qty type="float">42.0</qty>
    </item>
  </items>
  <notify type="boolean">true</notify>
  <appendComment type="boolean">true</appendComment>
  <comment>
    <extension-attributes>
    </extension-attributes>
    <comment>string</comment>
    <is-visible-on-front type="integer">42</is-visible-on-front>
  </comment>
  <arguments>
    <extension-attributes>
    </extension-attributes>
  </arguments>
</root>

Response examples (200)

Response examples (401)

{
  "message": "string",
  "errors": [
    {
      "message": "string",
      "parameters": [
        {
          "resources": "string",
          "fieldName": "string",
          "fieldValue": "string"
        }
      ]
    }
  ],
  "code": 42,
  "parameters": [
    {
      "resources": "string",
      "fieldName": "string",
      "fieldValue": "string"
    }
  ],
  "trace": "string"
}

Response examples (401)

<?xml version="1.0" encoding="UTF-8"?>
<root>
  <message>string</message>
  <errors type="array">
    <error>
      <message>string</message>
      <parameters type="array">
        <parameter>
          <resources>string</resources>
          <fieldName>string</fieldName>
          <fieldValue>string</fieldValue>
        </parameter>
      </parameters>
    </error>
  </errors>
  <code type="integer">42</code>
  <parameters type="array">
    <parameter>
      <resources>string</resources>
      <fieldName>string</fieldName>
      <fieldValue>string</fieldValue>
    </parameter>
  </parameters>
  <trace>string</trace>
</root>

Response examples (default)

{
  "message": "string",
  "errors": [
    {
      "message": "string",
      "parameters": [
        {
          "resources": "string",
          "fieldName": "string",
          "fieldValue": "string"
        }
      ]
    }
  ],
  "code": 42,
  "parameters": [
    {
      "resources": "string",
      "fieldName": "string",
      "fieldValue": "string"
    }
  ],
  "trace": "string"
}

Response examples (default)

<?xml version="1.0" encoding="UTF-8"?>
<root>
  <message>string</message>
  <errors type="array">
    <error>
      <message>string</message>
      <parameters type="array">
        <parameter>
          <resources>string</resources>
          <fieldName>string</fieldName>
          <fieldValue>string</fieldValue>
        </parameter>
      </parameters>
    </error>
  </errors>
  <code type="integer">42</code>
  <parameters type="array">
    <parameter>
      <resources>string</resources>
      <fieldName>string</fieldName>
      <fieldValue>string</fieldValue>
    </parameter>
  </parameters>
  <trace>string</trace>
</root>