---
title: "Modify an existing Fulfillment."
method: PUT
path: "/fulfillments/{id}.json"
tags: ["Fulfillments"]
---

# Modify an existing Fulfillment.

`PUT /fulfillments/{id}.json`

## Path parameters

- `id` integer, required

## Request body

- FulfillmentEdit
  - `fulfillment` FulfillmentEditFields
    - `shipment_status` 'requested' | 'in_transit' | 'delivered' | 'failed' — Status of the Fulfillment
    - `type` 'manual' | 'shipit' | 'chilexpress' | 'ctt' | 'dpd' | 'mrw' | 'correos_chile' | 'dhl' | 'servientrega' | 'starken' | 'bluexpress' | 'correos_express' — Type of fulfillment Service used
    - `tracking_number` string — Tracking Number associated with the fulfillment
    - `tracking_company` string — Tracking company responsible for the fulfillment
    - `tracking_url` string — Tracking URL, used only if tracking_company is set to 'other'
    - `external_id` string — Unique identifier of the Fulfillment used by the tracking company
    - `service_type` string — Type of Service requested to the tracking company
    - `message` string — Message to be sent with the order shipped email
    - `observations` string — Observations pertaining to the delivery process
    - `expected_arrival_from` string — First date expected for the fulfillment to arrive at customer place
    - `expected_arrival_to` string — Last date expected for the fulfillment to arrive at customer place

## Response `200`

OK

- Fulfillment
  - `fulfillment` FulfillmentFields
    - `id` integer — Unique identifier of the Fulfillment
    - `created_at` string — Fulfillment creation date
    - `updated_at` string — Fulfillment last update date
    - `tracking_number` string — Tracking Number associated with the fulfillment
    - `tracking_company` string — Tracking company responsible for the fulfillment
    - `type` string — Type of fulfillment Service used
    - `shipment_status` string — Status of the fulfillment
    - `label_url` string — Temporary Url of the Label. (24 Hours Link Avaibility)
    - `expected_arrival_from` string — First date expected for the fulfillment to arrive at customer place
    - `expected_arrival_to` string — Last date expected for the fulfillment to arrive at customer place
    - `fulfillment_address` object — Information about the address used in the fulfillment
      - `address` FulfillmentAddress
        - `name` string — Name of the Fulfillment's Address
        - `surname` string — Surname of the Fulfillment's Address
        - `address` string — Address of the Fulfillment's Address
        - `city` string — City of the Fulfillment's Address
        - `postal` string — Postal code of the Fulfillment's Address
        - `municipality` string — Municipality of the Fulfillment's Address
        - `region` string — Region code of the Fulfillment's Address (Use the FIPS standard - http://www.geonames.org/countries/)
        - `country` string — Country code of the Fulfillment's Address (ISO 3166-1 alpha-2)
    - `order_id` integer — Identifier of the order
    - `order` object — Information about the order related to the fulfillment
      - `order` Order
        - `order` OrderFields
          - `id` integer — Unique identifier of the Order
          - `source` TrafficSource
            - `created_from` string — From where the order was created: [checkout, api, admin, duplicate, recovery, pos]
            - `created_from_app_code` string — The code of the app that created the order if it was created by an app through the API
            - `source_name` string — Where the checkout originated
            - `medium` string — The medium that referred the customer to the checkout
            - `campaign` string — The campaign that referred the customer to the checkout
            - `referral_url` string — The website that referred the customer to the checkout
            - `referral_code` string — The code that referred the customer to the checkout
            - `user_agent` string — User agent of the referred request to checkout
            - `first_page_visited` string — The first url visited by the customer
            - `first_page_visited_at` string — The date when the customer visited the first page
            - `referral_source` string — The source that referred the customer to the website
          - `created_at` string — Order date
          - `completed_at` string — The date when the order was first completed.
          - `currency` string — Currency of the Order
          - `subtotal` number, float — Subtotal value for the given Order. Excluding taxes, shipping and discounts
          - `tax` number, float — Tax value for the given order
          - `shipping_tax` number, float — Shipping Tax value for the given order
          - `shipping` number, float — Shipping value for the given Order
          - `shipping_required` boolean — False if the order is digital.
          - `total` number, float — Total value for the given Order. Including taxes, shipping and discounts
          - `discount` number, float — Discount value for the given Order
          - `shipping_discount` number, float — Shipping Discount value for the given order
          - `gift_cards_discount` number, float — Gift Cards Discount value for the given order
          - `fulfillment_status` string — Fulfillment Status for Order (translated).
          - `shipping_method_id` integer — Shipping method e.g. Royal Mail
          - `shipping_service_id` integer — Shipping service
          - `shipping_method_name` string — Shipping method e.g. Royal Mail
          - `payment_method_name` string — Payment Method name used e.g. PayPal
          - `payment_method_type` string — Payment Method type used e.g. paypal
          - `payment_information` string — Payment information for the given Order
          - `payment_notification_id` string — Payment notification identifier
          - `additional_information` string — Additional information for the given Order
          - `duplicate_url` string — Duplicate Order URL for the given Order
          - `recovery_url` string — Recovery Order URL for the given Order
          - `review_url` string — Review Order URL for the given Order
          - `checkout_url` string — Store Checkout Order URL for the given Order
          - `coupons` string — Promotion Coupons used on the given Order
          - `promotions` unknown[] — Promotions used on the given Order
            - unknown
          - `customer` CustomerSimpleFields
            - `id` integer — Unique identifier of the Customer
            - `email` string — Email of the Customer
            - `phone` string — Phone of the Customer
            - `phone_prefix` string — Phone prefix of the Customer
            - `ip` string — IP of the Customer
            - `fullname` string — Customer fullname retrieved from the default billing address. Defaults to customer email if no name is found.
          - `shipping_branch` OrderShippingBranch
            - `id` integer — ID of the Order's Shipping Branch
            - `name` string — Name of the Order's Shipping Branch
          - `shipping_address` OrderShippingAddress
            - `name` string — Name of the Order's Shipping Address
            - `surname` string — Surname of the Order's Shipping Address
            - `address` string — Address of the Order's Shipping Address
            - `city` string — City of the Order's Shipping Address
            - `postal` string — Postal code of the Order's Shipping Address
            - `region` string — Region name of the Order's Shipping Address
            - `country` string — Country name of the Order's Shipping Address
            - `country_code` string — Country code of the Order's Shipping Address (ISO 3166-1 alpha-2)
            - `region_code` string — Region code of the Order's Shipping Address (Use the FIPS standard - http://www.geonames.org/countries/)
            - `street_number` number — Street number of the Order's Shipping Address
            - `complement` string — Complement of the Order's Shipping Address
            - `latitude` number — Latitude of the Order's Shipping Address
            - `longitude` number — Longitude of the Order's Shipping Address
            - `municipality` string — Municipality of the Order's Shipping Address
            - `neighbourhood` string — Third level of administrative subdivision of the Customer's Shipping Address used only for some countries (e.g. Mexico)
          - `billing_address` OrderBillingAddress
            - `name` string — Name of the Order's Billing Address
            - `surname` string — Surname of the Order's Billing Address
            - `taxid` string — TaxID of the Order's Billing Address
            - `address` string — Address of the Order's Billing Address
            - `city` string — City of the Order's Billing Address
            - `postal` string — Postal code of the Order's Billing Address
            - `region` string — Region name of the Order's Billing Address
            - `country` string — Country name of the Order's Billing Address
            - `country_code` string — Country code of the Order's Billing Address (ISO 3166-1 alpha-2)
            - `region_code` string — Region code of the Order's Billing Address (Use the FIPS standard - http://www.geonames.org/countries/)
            - `street_number` number — Street number of the Order's Billing Address
            - `complement` string — Complement of the Order's Billing Address
            - `municipality` string — Municipality of the Order's Billing Address
            - `neighbourhood` string — Third level of administrative subdivision of the Customer's Shipping Address used only for some countries (e.g. Mexico)
          - `pickup_address` OrderPickupAddress
            - `name` string — Name of the Order's Pickup Address
            - `surname` string — Surname of the Order's Pickup Address
            - `address` string — Address of the Order's Pickup Address
            - `city` string — City of the Order's Pickup Address
            - `postal` string — Postal code of the Order's Pickup Address
            - `region` string — Region name of the Order's Pickup Address
            - `country` string — Country name of the Order's Pickup Address
            - `country_code` string — Country code of the Order's Pickup Address (ISO 3166-1 alpha-2)
            - `region_code` string — Region code of the Order's Pickup Address (Use the FIPS standard - http://www.geonames.org/countries/)
            - `street_number` number — Street number of the Order's Pickup Address
            - `complement` string — Complement of the Order's Pickup Address
            - `municipality` string — Municipality of the Order's Pickup Address
            - `pickup_place_name` string — Name of the Pickup Place
          - `products` OrderProduct[]
            - `id` integer — Unique identifier of the original Product
            - `variant_id` integer — Unique identifier of the original Product Variant
            - `sku` string — Stock Keeping Unit of the Order Product
            - `name` string — Name of the Order Product
            - `image` string — Image URL of the Order Product
            - `qty` integer — Price of the Order Product
            - `price` number, float — Price of the Order Product
            - `discount` number, float — Discount of the Order Product
            - `weight` number, float — Weight of the Order Product
            - `taxes` OrderProductTax[]
              - …
            - `stock_locations` OrderProductStockLocations[]
              - …
          - `additional_fields` OrderAdditionalFields[] — Array of additional fields for the given Order
            - `label` string, string — Label of the additional field
            - `value` string, string — Value of the additional field
            - `id` integer — Id of the additional field
            - `area` string, string — Area of the additional field
          - `shipping_taxes` OrderShippingTax[]
            - `id` integer — Unique identifier of the Order Shipping Tax
            - `name` string — Tax name
            - `country` string — Code of the associated country
            - `region` string — Code of the associated region
            - `rate` number, float — Tax rate
            - `fixed` boolean — False if rate is a percentage and true if rate is monetary
            - `tax_on_shipping_price` boolean — False if shipping tax is not included on shipping price
          - `status` 'Abandoned' | 'Canceled' | 'Pending Payment' | 'Paid' — Status of the Order (translated).
          - `status_name` 'Abandoned' | 'Canceled' | 'Pending Payment' | 'Paid' — Status of the Order (translated).
          - `status_enum` 'abandoned' | 'canceled' | 'pending_payment' | 'paid' — Status of the Order (enum).
          - `tracking_url` string — Tracking URL for Order Fulfillment.
          - `tracking_company` string — Company Used for Order Fulfillment.
          - `tracking_number` string — Tracking Number for Order Fulfillment.
          - `shipping_option` 'delivery' | 'store_pickup' | 'no_shipping' — Shipping option for this order.
          - `same_day_delivery` boolean — True if same day delivery was selected for the order, false otherwise.
          - `shipment_status` 'Delivered' | 'Requested' | 'In Transit' | 'Failed' | 'Pickup Available' | 'Unfulfilled' — Shipment Status for Order and Order Fulfillment (translated).
          - `shipment_status_enum` 'delivered' | 'requested' | 'in_transit' | 'failed' | 'pickup_available' | 'unfulfilled' — Shipment Status for Order and Order Fulfillment (enum).
          - `recovered_from` integer — Show id of the order that was recovered from this order
          - `external_shipping_rate_id` string — Rate id for selected External Shipping Method rate
          - `external_shipping_rate_description` string — Rate description for selected External Shipping Method rate
          - `billing_information` BillingInformationFields
            - `business_activity` string — Giro
            - `company_name` string — Razon Social
            - `taxpayer_type` string — Tipo de Contribuinte

## Other responses

- `404` — Fulfillment Not Found.

---

[API](https://skmtc.net/jumpseller/apis/jumpseller-api.md) · [All operations](https://skmtc.net/jumpseller/apis/jumpseller-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/jumpseller/jumpseller-api/versions/7512c6ae3524/schema)
