purchase_order_update

Updates a purchase order.

Arguments

Argument	Type	Required	Default	Description
`data`	UpdatePurchaseOrderInput!	Yes

Return Type

UpdatePurchaseOrderOutput

Mutation

mutation purchase_order_update(
  $data: UpdatePurchaseOrderInput!
) {
  purchase_order_update(
    data: $data
  ) {
    request_id
    complexity
    purchase_order {
      ...PurchaseOrderFragment
    
      id
      legacy_id
      po_number
      account_id
      warehouse_id
      vendor_id
      created_at
      po_date
      date_closed
      arrived_at
      packing_note
      fulfillment_status
      po_note
      description
      partner_order_number
      subtotal
      discount
      total_price
      tax
      shipping_method
      shipping_carrier
      shipping_name
      shipping_price
      tracking_number
      pdf
      images
      payment_method
      payment_due_by
      payment_note
      locking
      locked_by_user_id
      line_items {
        ...PurchaseOrderLineItemConnectionFragment
      
        pageInfo {
          ...PageInfoFragment
        
          hasNextPage
          hasPreviousPage
          startCursor
          endCursor
        }
        edges {
          ...PurchaseOrderLineItemEdgeFragment
        
          node {
            ...PurchaseOrderLineItemFragment
          
            id
            legacy_id
            po_id
            account_id
            warehouse_id
            vendor_id
            po_number
            sku
            vendor_sku
            product_id
            variant_id
            quantity
            quantity_received
            quantity_rejected
            price
            product_name
            option_title
            expected_weight_in_lbs
            fulfillment_status
            sell_ahead
            note
            partner_line_item_id
            barcode
            updated_at
            created_at
            vendor {
              ...VendorFragment
            
              id
              legacy_id
              name
              email
              account_number
              account_id
              address {
                ...AddressFragment
              
                name
                address1
                address2
                city
                state
                country
                zip
                phone
              }
              currency
              internal_note
              default_po_note
              logo
              partner_vendor_id
              created_at
            }
            product {
              ...WarehouseProductFragment
            
              id
              legacy_id
              account_id
              sku
              warehouse_id
              warehouse_identifier
              price
              value
              value_currency
              on_hand
              inventory_bin
              inventory_overstock_bin
              reserve_inventory
              replenishment_level
              replenishment_max_level
              replenishment_increment
              reorder_amount
              reorder_level
              backorder
              allocated
              available
              non_sellable_quantity
              in_tote
              custom
              customs_value
              created_at
              updated_at
              sell_ahead
              active
              warehouse {
                ...WarehouseFragment
              
                id
                legacy_id
                account_id
                identifier
                dynamic_slotting
                invoice_email
                invoice_note
                invoice_logo_url
                phone_number
                profile
                language
                manual_order_prefix
                show_phone_on_invoice
                only_pick_orders_with_required_ship_date_today_or_earlier
                exclude_stock_from_available_to_sell
                address {
                  ...AddressFragment
                
                  name
                  address1
                  address2
                  city
                  state
                  country
                  zip
                  phone
                }
                return_address {
                  ...AddressFragment
                
                  name
                  address1
                  address2
                  city
                  state
                  country
                  zip
                  phone
                }
                invoice_address {
                  ...AddressFragment
                
                  name
                  address1
                  address2
                  city
                  state
                  country
                  zip
                  phone
                }
                label_address {
                  ...AddressFragment
                
                  name
                  address1
                  address2
                  city
                  state
                  country
                  zip
                  phone
                }
                company_name
                company_alias
                active
                products {
                  ...ProductConnectionFragment
                
                  pageInfo {
                    ...PageInfoFragment
                  
                    hasNextPage
                    hasPreviousPage
                    startCursor
                    endCursor
                  }
                  edges {
                    ...ProductEdgeFragment
                  
                    node {
                      ...ProductFragment
                    }
                    cursor
                  }
                }
              }
              product {
                ...ProductFragment
              
                id
                legacy_id
                account_id
                name
                sku
                price
                value
                value_currency
                barcode
                country_of_manufacture
                dimensions {
                  ...DimensionsFragment
                
                  weight
                  height
                  width
                  length
                }
                tariff_code
                kit
                kit_build
                no_air
                final_sale
                customs_value
                customs_description
                not_owned
                dropship
                needs_serial_number
                thumbnail
                large_thumbnail
                created_at
                updated_at
                product_note
                virtual
                ignore_on_invoice
                ignore_on_customs
                active
                needs_lot_tracking
                is_assembly
                packer_note
                size
                style
                merchant_product_id
                non_standard_manufacturer_product_id
                standard_manufacturer_product_id
                vendor_part_number
                consumer_package_code
                buyer_part_number
                buyer_style_number
                auto_pack
                must_ship_alone
                warehouse_products {
                  ...WarehouseProductFragment
                }
                fba_inventory {
                  ...FbaInventoryFragment
                
                  id
                  legacy_id
                  quantity
                  marketplace_id
                  merchant_id
                }
                images {
                  ...ProductImageFragment
                
                  src
                  position
                }
                tags
                vendors {
                  ...ProductVendorFragment
                
                  vendor_id
                  vendor_sku
                  price
                }
                components {
                  ...ProductFragment
                }
                kit_components {
                  ...KitComponentFragment
                
                  id
                  legacy_id
                  account_id
                  sku
                  quantity
                  product {
                    ...ProductFragment
                  }
                }
                assembly_components {
                  ...AssemblyComponentFragment
                
                  id
                  legacy_id
                  account_id
                  sku
                  quantity
                }
                cases {
                  ...CaseFragment
                
                  id
                  legacy_id
                  case_barcode
                  case_quantity
                }
              }
              inbounds {
                ...WarehouseProductInboundConnectionFragment
              
                pageInfo {
                  ...PageInfoFragment
                
                  hasNextPage
                  hasPreviousPage
                  startCursor
                  endCursor
                }
                edges {
                  ...WarehouseProductInboundEdgeFragment
                
                  node {
                    ...WarehouseProductInboundFragment
                  
                    id
                    legacy_id
                    sku
                    warehouse_id
                    po_id
                    purchase_order_line_item_id
                    po_date
                    quantity
                    quantity_received
                    quantity_rejected
                    sell_ahead
                    status
                  }
                  cursor
                }
              }
              locations {
                ...ItemLocationConnectionFragment
              
                pageInfo {
                  ...PageInfoFragment
                
                  hasNextPage
                  hasPreviousPage
                  startCursor
                  endCursor
                }
                edges {
                  ...ItemLocationEdgeFragment
                
                  node {
                    ...ItemLocationFragment
                  
                    id
                    legacy_id
                    account_id
                    warehouse_id
                    location_id
                    sku
                    quantity
                    loose_quantity
                    allocated_quantity
                    created_at
                    updated_at
                    location {
                      ...LocationFragment
                    }
                    location_type {
                      ...LocationTypeFragment
                    }
                    expiration_lot {
                      ...LotFragment
                    }
                    lpns {
                      ...LicensePlateNumberConnectionFragment
                    }
                    product {
                      ...ProductFragment
                    }
                    warehouse_product {
                      ...WarehouseProductFragment
                    }
                  }
                  cursor
                }
              }
            }
            expiration_lots {
              ...LotConnectionFragment
            
              pageInfo {
                ...PageInfoFragment
              
                hasNextPage
                hasPreviousPage
                startCursor
                endCursor
              }
              edges {
                ...LotEdgeFragment
              
                node {
                  ...LotFragment
                
                  id
                  legacy_id
                  account_id
                  po_id
                  name
                  sku
                  created_at
                  updated_at
                  expires_at
                  received_at
                  is_active
                  locations {
                    ...LocationConnectionFragment
                  
                    pageInfo {
                      ...PageInfoFragment
                    }
                    edges {
                      ...LocationEdgeFragment
                    }
                  }
                  purchase_orders {
                    ...PurchaseOrderConnectionFragment
                  
                    pageInfo {
                      ...PageInfoFragment
                    }
                    edges {
                      ...PurchaseOrderEdgeFragment
                    }
                  }
                }
                cursor
              }
            }
          }
          cursor
        }
      }
      attachments {
        ...PurchaseOrderAttachmentConnectionFragment
      
        pageInfo {
          ...PageInfoFragment
        
          hasNextPage
          hasPreviousPage
          startCursor
          endCursor
        }
        edges {
          ...PurchaseOrderAttachmentEdgeFragment
        
          node {
            ...PurchaseOrderAttachmentFragment
          
            id
            legacy_id
            url
            user_id
            account_id
            po_li_sku
            description
            filename
            file_type
            file_size
            created_at
          }
          cursor
        }
      }
      vendor {
        ...VendorFragment
      
        id
        legacy_id
        name
        email
        account_number
        account_id
        address {
          ...AddressFragment
        
          name
          address1
          address2
          city
          state
          country
          zip
          phone
        }
        currency
        internal_note
        default_po_note
        logo
        partner_vendor_id
        created_at
      }
      warehouse {
        ...WarehouseFragment
      
        id
        legacy_id
        account_id
        identifier
        dynamic_slotting
        invoice_email
        invoice_note
        invoice_logo_url
        phone_number
        profile
        language
        manual_order_prefix
        show_phone_on_invoice
        only_pick_orders_with_required_ship_date_today_or_earlier
        exclude_stock_from_available_to_sell
        address {
          ...AddressFragment
        
          name
          address1
          address2
          city
          state
          country
          zip
          phone
        }
        return_address {
          ...AddressFragment
        
          name
          address1
          address2
          city
          state
          country
          zip
          phone
        }
        invoice_address {
          ...AddressFragment
        
          name
          address1
          address2
          city
          state
          country
          zip
          phone
        }
        label_address {
          ...AddressFragment
        
          name
          address1
          address2
          city
          state
          country
          zip
          phone
        }
        company_name
        company_alias
        active
        products {
          ...ProductConnectionFragment
        
          pageInfo {
            ...PageInfoFragment
          
            hasNextPage
            hasPreviousPage
            startCursor
            endCursor
          }
          edges {
            ...ProductEdgeFragment
          
            node {
              ...ProductFragment
            
              id
              legacy_id
              account_id
              name
              sku
              price
              value
              value_currency
              barcode
              country_of_manufacture
              dimensions {
                ...DimensionsFragment
              
                weight
                height
                width
                length
              }
              tariff_code
              kit
              kit_build
              no_air
              final_sale
              customs_value
              customs_description
              not_owned
              dropship
              needs_serial_number
              thumbnail
              large_thumbnail
              created_at
              updated_at
              product_note
              virtual
              ignore_on_invoice
              ignore_on_customs
              active
              needs_lot_tracking
              is_assembly
              packer_note
              size
              style
              merchant_product_id
              non_standard_manufacturer_product_id
              standard_manufacturer_product_id
              vendor_part_number
              consumer_package_code
              buyer_part_number
              buyer_style_number
              auto_pack
              must_ship_alone
              warehouse_products {
                ...WarehouseProductFragment
              
                id
                legacy_id
                account_id
                sku
                warehouse_id
                warehouse_identifier
                price
                value
                value_currency
                on_hand
                inventory_bin
                inventory_overstock_bin
                reserve_inventory
                replenishment_level
                replenishment_max_level
                replenishment_increment
                reorder_amount
                reorder_level
                backorder
                allocated
                available
                non_sellable_quantity
                in_tote
                custom
                customs_value
                created_at
                updated_at
                sell_ahead
                active
                warehouse {
                  ...WarehouseFragment
                }
                product {
                  ...ProductFragment
                }
                inbounds {
                  ...WarehouseProductInboundConnectionFragment
                
                  pageInfo {
                    ...PageInfoFragment
                  
                    hasNextPage
                    hasPreviousPage
                    startCursor
                    endCursor
                  }
                  edges {
                    ...WarehouseProductInboundEdgeFragment
                  
                    node {
                      ...WarehouseProductInboundFragment
                    }
                    cursor
                  }
                }
                locations {
                  ...ItemLocationConnectionFragment
                
                  pageInfo {
                    ...PageInfoFragment
                  
                    hasNextPage
                    hasPreviousPage
                    startCursor
                    endCursor
                  }
                  edges {
                    ...ItemLocationEdgeFragment
                  
                    node {
                      ...ItemLocationFragment
                    }
                    cursor
                  }
                }
              }
              fba_inventory {
                ...FbaInventoryFragment
              
                id
                legacy_id
                quantity
                marketplace_id
                merchant_id
              }
              images {
                ...ProductImageFragment
              
                src
                position
              }
              tags
              vendors {
                ...ProductVendorFragment
              
                vendor_id
                vendor_sku
                price
              }
              components {
                ...ProductFragment
              }
              kit_components {
                ...KitComponentFragment
              
                id
                legacy_id
                account_id
                sku
                quantity
                product {
                  ...ProductFragment
                }
              }
              assembly_components {
                ...AssemblyComponentFragment
              
                id
                legacy_id
                account_id
                sku
                quantity
              }
              cases {
                ...CaseFragment
              
                id
                legacy_id
                case_barcode
                case_quantity
              }
            }
            cursor
          }
        }
      }
      origin_of_shipment
      tracking_numbers {
        ...PurchaseOrderTrackingNumberConnectionFragment
      
        pageInfo {
          ...PageInfoFragment
        
          hasNextPage
          hasPreviousPage
          startCursor
          endCursor
        }
        edges {
          ...PurchaseOrderTrackingNumberEdgeFragment
        
          node {
            ...PurchaseOrderTrackingNumberFragment
          
            id
            legacy_id
            po_id
            carrier_id
            carrier_value
            tracking_number
          }
          cursor
        }
      }
      ship_date
    }
  }
}

Variables

{
  "data": {
    "customer_account_id": "QWNjb3VudDoxMjM0",
    "po_id": "UHVyY2hhc2VPcmRlcjoxMjM0",
    "packing_note": "Customer requested expedited handling.",
    "po_note": "Customer requested expedited handling.",
    "description": "Customer requested expedited handling.",
    "partner_order_number": "SO-100045",
    "discount": "19.99",
    "tax": "19.99",
    "line_items": [[{sku: "BLUE-TEE-M", quantity: 2}]],
    "shipping_method": "ups_ground",
    "shipping_carrier": "ups",
    "shipping_name": "PO-100045",
    "shipping_price": "19.99",
    "tracking_number": "1Z999AA10123456784",
    "pdf": "https://example.com/labels/SHIP-1001.pdf",
    "payment_method": "credit_card",
    "payment_due_by": "2026-07-15",
    "payment_note": "Customer requested expedited handling.",
    "po_date": "2026-07-09T15:30:00Z",
    "clear_po_date": true
  }
}

Response

{
  "data": {
    "purchase_order_update": {
      "request_id": "UmVjb3JkOjEyMzQ=",
      "complexity": 100,
      "purchase_order": {id: "T3JkZXI6MTIzNA==", order_number: "SO-100045"}
    }
  }
}