@shippo/shippo-mcp 0.8.39 → 0.8.48

package/esm/models/order.js.map

@@ -1 +1 @@
-{"version":3,"file":"order.js","sourceRoot":"","sources":["../../src/models/order.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AACzB,OAAO,EAAW,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAC1D,OAAO,EAAY,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAC7D,OAAO,EAEL,0BAA0B,GAC3B,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAEL,yBAAyB,GAC1B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAkB,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAI/E,MAAM,CAAC,MAAM,0BAA0B,GAInC,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAyBjB,MAAM,CAAC,MAAM,eAAe,GAA4C,CAAC;KACtE,MAAM,CAAC;IACN,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,YAAY,EAAE,iBAAiB,CAAC,QAAQ,EAAE;IAC1C,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC,QAAQ,EAAE;IAClD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACnC,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACnC,YAAY,EAAE,yBAAyB,CAAC,QAAQ,EAAE;IAClD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACpC,sBAAsB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7C,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACtC,QAAQ,EAAE,0BAA0B,CAAC,QAAQ,EAAE;IAC/C,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACrC,UAAU,EAAE,iBAAiB;IAC7B,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,0BAA0B,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC1E,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,WAAW,EAAE,wBAAwB,CAAC,QAAQ,EAAE;CACjD,CAAC,CAAC"}
+{"version":3,"file":"order.js","sourceRoot":"","sources":["../../src/models/order.ts"],"names":[],"mappings":"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"}

package/esm/models/ordercreaterequest.d.ts

@@ -4,18 +4,18 @@ import { LineItemBase } from "./lineitembase.js";
 import { OrderStatusEnum } from "./orderstatusenum.js";
 import { WeightUnitEnum } from "./weightunitenum.js";
 export type OrderCreateRequest = {
-    currency?: string | undefined;
-    notes?: string | undefined;
-    order_number?: string | undefined;
+    currency?: string | null | undefined;
+    notes?: string | null | undefined;
+    order_number?: string | null | undefined;
     order_status?: OrderStatusEnum | undefined;
     placed_at: string;
-    shipping_cost?: string | undefined;
-    shipping_cost_currency?: string | undefined;
-    shipping_method?: string | undefined;
-    subtotal_price?: string | undefined;
-    total_price?: string | undefined;
-    total_tax?: string | undefined;
-    weight?: string | undefined;
+    shipping_cost?: string | null | undefined;
+    shipping_cost_currency?: string | null | undefined;
+    shipping_method?: string | null | undefined;
+    subtotal_price?: string | null | undefined;
+    total_price?: string | null | undefined;
+    total_tax?: string | null | undefined;
+    weight?: string | null | undefined;
     weight_unit?: WeightUnitEnum | undefined;
     from_address?: AddressCreateRequest | undefined;
     to_address: AddressCreateRequest;

package/esm/models/ordercreaterequest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ordercreaterequest.d.ts","sourceRoot":"","sources":["../../src/models/ordercreaterequest.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AACzB,OAAO,EACL,oBAAoB,EAErB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,YAAY,EAA0B,MAAM,mBAAmB,CAAC;AACzE,OAAO,EACL,eAAe,EAEhB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,cAAc,EAA4B,MAAM,qBAAqB,CAAC;AAE/E,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,YAAY,CAAC,EAAE,eAAe,GAAG,SAAS,CAAC;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACnC,sBAAsB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5C,eAAe,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACrC,cAAc,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,WAAW,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IACjC,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,WAAW,CAAC,EAAE,cAAc,GAAG,SAAS,CAAC;IACzC,YAAY,CAAC,EAAE,oBAAoB,GAAG,SAAS,CAAC;IAChD,UAAU,EAAE,oBAAoB,CAAC;IACjC,UAAU,CAAC,EAAE,KAAK,CAAC,YAAY,CAAC,GAAG,SAAS,CAAC;CAC9C,CAAC;AAEF,eAAO,MAAM,4BAA4B,EAAE,CAAC,CAAC,OAAO,CAClD,kBAAkB,EAClB,CAAC,CAAC,UAAU,EACZ,OAAO,CAkBP,CAAC"}
+{"version":3,"file":"ordercreaterequest.d.ts","sourceRoot":"","sources":["../../src/models/ordercreaterequest.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AACzB,OAAO,EACL,oBAAoB,EAErB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,YAAY,EAA0B,MAAM,mBAAmB,CAAC;AACzE,OAAO,EACL,eAAe,EAEhB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,cAAc,EAA4B,MAAM,qBAAqB,CAAC;AAE/E,MAAM,MAAM,kBAAkB,GAAG;IAC/B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACrC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAClC,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACzC,YAAY,CAAC,EAAE,eAAe,GAAG,SAAS,CAAC;IAC3C,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAC1C,sBAAsB,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACnD,eAAe,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAC5C,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IAC3C,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACxC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACtC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,CAAC;IACnC,WAAW,CAAC,EAAE,cAAc,GAAG,SAAS,CAAC;IACzC,YAAY,CAAC,EAAE,oBAAoB,GAAG,SAAS,CAAC;IAChD,UAAU,EAAE,oBAAoB,CAAC;IACjC,UAAU,CAAC,EAAE,KAAK,CAAC,YAAY,CAAC,GAAG,SAAS,CAAC;CAC9C,CAAC;AAEF,eAAO,MAAM,4BAA4B,EAAE,CAAC,CAAC,OAAO,CAClD,kBAAkB,EAClB,CAAC,CAAC,UAAU,EACZ,OAAO,CAkBP,CAAC"}

package/esm/models/ordercreaterequest.js

@@ -7,21 +7,21 @@ import { LineItemBase$zodSchema } from "./lineitembase.js";
 import { OrderStatusEnum$zodSchema, } from "./orderstatusenum.js";
 import { WeightUnitEnum$zodSchema } from "./weightunitenum.js";
 export const OrderCreateRequest$zodSchema = z.object({
-    currency: z.string().optional(),
+    currency: z.string().nullable().optional(),
     from_address: AddressCreateRequest$zodSchema.optional(),
     line_items: z.array(LineItemBase$zodSchema).optional(),
-    notes: z.string().optional(),
-    order_number: z.string().optional(),
+    notes: z.string().nullable().optional(),
+    order_number: z.string().nullable().optional(),
     order_status: OrderStatusEnum$zodSchema.optional(),
     placed_at: z.string(),
-    shipping_cost: z.string().optional(),
-    shipping_cost_currency: z.string().optional(),
-    shipping_method: z.string().optional(),
-    subtotal_price: z.string().optional(),
+    shipping_cost: z.string().nullable().optional(),
+    shipping_cost_currency: z.string().nullable().optional(),
+    shipping_method: z.string().nullable().optional(),
+    subtotal_price: z.string().nullable().optional(),
     to_address: AddressCreateRequest$zodSchema,
-    total_price: z.string().optional(),
-    total_tax: z.string().optional(),
-    weight: z.string().optional(),
+    total_price: z.string().nullable().optional(),
+    total_tax: z.string().nullable().optional(),
+    weight: z.string().nullable().optional(),
     weight_unit: WeightUnitEnum$zodSchema.optional(),
 });
 //# sourceMappingURL=ordercreaterequest.js.map

package/esm/models/ordercreaterequest.js.map

@@ -1 +1 @@
-{"version":3,"file":"ordercreaterequest.js","sourceRoot":"","sources":["../../src/models/ordercreaterequest.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AACzB,OAAO,EAEL,8BAA8B,GAC/B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAgB,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AACzE,OAAO,EAEL,yBAAyB,GAC1B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAkB,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAqB/E,MAAM,CAAC,MAAM,4BAA4B,GAIrC,CAAC,CAAC,MAAM,CAAC;IACX,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,YAAY,EAAE,8BAA8B,CAAC,QAAQ,EAAE;IACvD,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC,QAAQ,EAAE;IACtD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC5B,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACnC,YAAY,EAAE,yBAAyB,CAAC,QAAQ,EAAE;IAClD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACpC,sBAAsB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7C,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACtC,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACrC,UAAU,EAAE,8BAA8B;IAC1C,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAClC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAChC,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,WAAW,EAAE,wBAAwB,CAAC,QAAQ,EAAE;CACjD,CAAC,CAAC"}
+{"version":3,"file":"ordercreaterequest.js","sourceRoot":"","sources":["../../src/models/ordercreaterequest.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AACzB,OAAO,EAEL,8BAA8B,GAC/B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAgB,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AACzE,OAAO,EAEL,yBAAyB,GAC1B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAkB,wBAAwB,EAAE,MAAM,qBAAqB,CAAC;AAqB/E,MAAM,CAAC,MAAM,4BAA4B,GAIrC,CAAC,CAAC,MAAM,CAAC;IACX,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC1C,YAAY,EAAE,8BAA8B,CAAC,QAAQ,EAAE;IACvD,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,sBAAsB,CAAC,CAAC,QAAQ,EAAE;IACtD,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IACvC,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC9C,YAAY,EAAE,yBAAyB,CAAC,QAAQ,EAAE;IAClD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,aAAa,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC/C,sBAAsB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IACxD,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IACjD,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAChD,UAAU,EAAE,8BAA8B;IAC1C,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC7C,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC3C,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IACxC,WAAW,EAAE,wBAAwB,CAAC,QAAQ,EAAE;CACjD,CAAC,CAAC"}

package/manifest.json

@@ -1,7 +1,7 @@
 {
   "manifest_version": "0.3",
   "name": "@shippo/shippo-mcp",
-  "version": "0.8.39",
+  "version": "0.8.48",
   "description": "",
   "long_description": "Shippo external API.: Use this API to integrate with the Shippo service",
   "author": {
@@ -42,11 +42,11 @@
     },
     {
       "name": "batches-create",
-      "description": "Create a batch\n\nCreates a new batch object for purchasing shipping labels for many shipments at once. Batches are created asynchronously. This means that the API response won't include your batch shipments yet. You need to retrieve the batch later to verify that all batch shipments are valid."
+      "description": "Create a batch\n\nCreates a new batch object for purchasing shipping labels for many shipments at once. Batches are created asynchronously. This means that the API response won't include your batch shipments yet. You need to retrieve the batch later to verify that all batch shipments are valid.\n\n**IMPORTANT: There is NO batches-list endpoint in the Shippo API.**\nYou must store the batch \\`object_id\\` returned from this endpoint to retrieve batches later using \\`batches-get\\`.\n\n**Workflow:**\n1. Create batch → Save the returned \\`object_id\\`\n2. Retrieve batch status using \\`batches-get\\` with the saved ID\n3. Add/remove shipments as needed\n4. Purchase the batch when ready\n"
     },
     {
       "name": "batches-get",
-      "description": "Retrieve a batch\n\nReturns a batch using an object ID. <br> Batch shipments are displayed 100 at a time.  You can iterate \nthrough each \\`page\\` using the \\`?page= query\\` parameter.  You can also filter based on batch shipment \nstatus, for example, by passing a query param like \\`?object_results=creation_failed\\`. <br> \nFor more details on filtering results, see our guide on <a href=\"https://docs.goshippo.com/docs/api_concepts/filtering/\" target=\"blank\"> filtering</a>."
+      "description": "Retrieve a batch\n\nReturns a batch using an object ID. Batch shipments are displayed 100 at a time. You can iterate through each \\`page\\` using the \\`?page=\\` query parameter. You can also filter based on batch shipment status, for example, by passing a query param like \\`?object_results=creation_failed\\`.\n\n**IMPORTANT: There is NO batches-list endpoint in the Shippo API.**\nYou must know the batch \\`object_id\\` (returned when you created the batch) to retrieve it.\nStore batch IDs when creating batches if you need to access them later.\n\n**URL HANDLING:** This response contains \\`label_url\\` (array of download URLs).\nWhen displaying URLs, ALWAYS show the complete URL without truncation.\nNever replace parts with \"...\" - S3 signed URLs will break if truncated.\n"
     },
     {
       "name": "batches-add-shipments",
@@ -130,7 +130,7 @@
     },
     {
       "name": "manifests-list",
-      "description": "List all manifests\n\nReturns a list of all manifest objects."
+      "description": "Returns a list of all manifest objects.\n\n**⚠️ URL HANDLING - CRITICAL:**\nEach manifest contains a \\`documents\\` field with URLs to scan form PDFs.\nWhen displaying these URLs:\n- ALWAYS show the COMPLETE URL - NEVER truncate or replace parts with \"...\"\n- These are S3 signed URLs that break if modified\n- Display URLs in a code block AND as a clickable hyperlink\n"
     },
     {
       "name": "manifests-create",
@@ -138,7 +138,7 @@
     },
     {
       "name": "manifests-get",
-      "description": "Retrieve a manifest\n\nReturns an existing manifest using an object ID."
+      "description": "Returns an existing manifest using an object ID.\n\n**⚠️ URL HANDLING - CRITICAL:**\nThe manifest contains a \\`documents\\` field with URLs to scan form PDFs.\nWhen displaying these URLs:\n- ALWAYS show the COMPLETE URL - NEVER truncate or replace parts with \"...\"\n- These are S3 signed URLs that break if modified\n- Display URLs in a code block AND as a clickable hyperlink\n"
     },
     {
       "name": "orders-list",
@@ -234,19 +234,19 @@
     },
     {
       "name": "tracking-status-get",
-      "description": "Get tracking status for a shipment using carrier and tracking number.\n\n**IMPORTANT TEST MODE BEHAVIOR:**\nWhen using test tokens, you MUST use 'shippo' as the Carrier parameter, \nnot the actual carrier names like 'USPS', 'UPS', 'FedEx', etc.\n\n**Test Mode Usage:**\n\\`\\`\\`json\n{\n  \"Carrier\": \"shippo\",\n  \"TrackingNumber\": \"your_tracking_number\"\n}\n\\`\\`\\`\n\n**Production Mode Usage:**\n\\`\\`\\`json\n{\n  \"Carrier\": \"USPS\",  // or \"UPS\", \"FedEx\", etc.\n  \"TrackingNumber\": \"your_tracking_number\"\n}\n\\`\\`\\`\n\nThe API will return an error if you use real carrier names with test tokens.\n"
+      "description": "Get tracking status for a shipment using carrier and tracking number.\n\n**IMPORTANT TEST MODE BEHAVIOR:**\nWhen using test tokens, you MUST use 'shippo' as the Carrier parameter, \nnot the actual carrier names like 'USPS', 'UPS', 'FedEx', etc.\n\n**Test Mode Usage:**\n\\`\\`\\`json\n{\n  \"Carrier\": \"shippo\",\n  \"TrackingNumber\": \"your_tracking_number\"\n}\n\\`\\`\\`\n\n**Production Mode Usage:**\n\\`\\`\\`json\n{\n  \"Carrier\": \"USPS\",  // or \"UPS\", \"FedEx\", etc.\n  \"TrackingNumber\": \"your_tracking_number\"\n}\n\\`\\`\\`\n\nThe API will return an error if you use real carrier names with test tokens.\n\n**⚠️ URL HANDLING - CRITICAL:**\nThe response may include tracking URLs. When displaying any URLs:\n- ALWAYS show the COMPLETE URL - NEVER truncate or replace parts with \"...\"\n- Display URLs in a code block AND as a clickable hyperlink\n"
     },
     {
       "name": "transactions-list",
-      "description": "**LIST TRANSACTIONS (Purchased Labels)** - Use this for finding shipped/delivered packages!\n\nThis tool lists transaction objects, which represent purchased shipping labels. Each transaction contains:\n- Tracking number and tracking URL\n- Label URL for printing\n- Tracking status (UNKNOWN, PRE_TRANSIT, TRANSIT, DELIVERED, RETURNED, FAILURE)\n- Purchase date and carrier info\n\n**IMPORTANT DISTINCTIONS:**\n- Transactions = Purchased shipping labels\n- Transactions HAVE tracking status and tracking numbers\n- Use \\`shipments-list\\` for rate quotes (unpurchased shipments)\n\n**When to use this tool:**\n- Find delivered packages → filter by \\`tracking_status: \"DELIVERED\"\\`\n- Find packages in transit → filter by \\`tracking_status: \"TRANSIT\"\\`\n- List all purchased labels\n- Find a specific label by rate ID\n\n**Available Filters:**\n- \\`tracking_status\\`: UNKNOWN, PRE_TRANSIT, TRANSIT, DELIVERED, RETURNED, FAILURE\n- \\`object_status\\`: WAITING, QUEUED, SUCCESS, ERROR, REFUNDED, REFUNDPENDING, REFUNDREJECTED\n- \\`rate\\`: Filter by rate ID\n- \\`page/results\\`: Pagination\n\n**Example Use Cases:**\n- \"Show delivered shipments\" → \\`{tracking_status: \"DELIVERED\"}\\`\n- \"Show packages in transit\" → \\`{tracking_status: \"TRANSIT\"}\\`\n- \"Show all labels\" → \\`{results: 25}\\`\n\n**Note on Test Mode:**\nTest transactions will always show \\`tracking_status: \"UNKNOWN\"\\` because they don't receive real carrier tracking updates.\n"
+      "description": "**LIST TRANSACTIONS (Purchased Labels)** - Use this for finding shipped/delivered packages!\n\nThis tool lists transaction objects, which represent purchased shipping labels. Each transaction contains:\n- Tracking number and tracking URL\n- Label URL for printing\n- Tracking status (UNKNOWN, PRE_TRANSIT, TRANSIT, DELIVERED, RETURNED, FAILURE)\n- Purchase date and carrier info\n\n**IMPORTANT DISTINCTIONS:**\n- Transactions = Purchased shipping labels\n- Transactions HAVE tracking status and tracking numbers\n- Use \\`shipments-list\\` for rate quotes (unpurchased shipments)\n\n**When to use this tool:**\n- Find delivered packages → filter by \\`tracking_status: \"DELIVERED\"\\`\n- Find packages in transit → filter by \\`tracking_status: \"TRANSIT\"\\`\n- List all purchased labels\n- Find a specific label by rate ID\n\n**Available Filters:**\n- \\`tracking_status\\`: UNKNOWN, PRE_TRANSIT, TRANSIT, DELIVERED, RETURNED, FAILURE\n- \\`object_status\\`: WAITING, QUEUED, SUCCESS, ERROR, REFUNDED, REFUNDPENDING, REFUNDREJECTED\n- \\`rate\\`: Filter by rate ID\n- \\`page/results\\`: Pagination\n\n**Example Use Cases:**\n- \"Show delivered shipments\" → \\`{tracking_status: \"DELIVERED\"}\\`\n- \"Show packages in transit\" → \\`{tracking_status: \"TRANSIT\"}\\`\n- \"Show all labels\" → \\`{results: 25}\\`\n\n**Note on Test Mode:**\nTest transactions will always show \\`tracking_status: \"UNKNOWN\"\\` because they don't receive real carrier tracking updates.\n\n**⚠️ URL HANDLING - CRITICAL:**\nEach transaction may include URLs (label_url, qr_code_url, tracking_url_provider).\nWhen displaying these URLs:\n- ALWAYS show the COMPLETE URL - NEVER truncate or replace parts with \"...\"\n- These are S3 signed URLs that break if modified\n- Display URLs in a code block AND as a clickable hyperlink\n"
     },
     {
       "name": "transactions-create",
-      "description": "Creates a shipping label by purchasing an existing rate.\n\n**IMPORTANT:** The request parameter must be a JSON object, not a string.\n\n**Usage:**\nThis tool creates shipping labels by purchasing existing rates from shipments.\nFirst create a shipment to get rates, then use this tool with the rate ID.\n\n**Required Format:**\n\\`\\`\\`json\n{\n  \"rate\": \"rate_id_here\"\n}\n\\`\\`\\`\n\n**Working Example:**\n\\`\\`\\`json\n{\n  \"rate\": \"b3b719ce08754a249a1fc20db7a61f4b\",\n  \"async\": false\n}\n\\`\\`\\`\n\n**INTERNATIONAL SHIPMENTS - CRITICAL NOTES:**\n- **ALWAYS use \\`async: true\\` for international shipments** to avoid timeouts\n- **Server load can cause 500/504 errors** - retry with async processing\n- **Customs declaration must be attached to shipment** before label creation\n\n**International Example:**\n\\`\\`\\`json\n{\n  \"rate\": \"international_rate_id\",\n  \"async\": true\n}\n\\`\\`\\`\n\n**Error Handling:**\n- If you get 504 Gateway timeout → Use \\`async: true\\`\n- If you get 500 Internal Server Error → Retry with \\`async: true\\`\n- If customs error → Ensure shipment has valid customs_declaration\n\n**Optional Parameters:**\n- \\`async\\`: **Set to true for international** (default: false)\n- \\`label_file_type\\`: PDF_4x6, PNG, etc.\n- \\`metadata\\`: Custom metadata string\n- \\`order\\`: Order ID reference\n\n**Workflow:**\n1. Create shipment → Get rates\n2. **For international: Attach customs declaration**\n3. Choose rate → Use this tool with rate ID\n4. **For international: Use async=true**\n5. **If async: Poll transaction status until complete**\n\n**Async Processing Pattern:**\n\\`\\`\\`javascript\n// 1. Create async transaction\n{\"rate\": \"rate_id\", \"async\": true}\n\n// 2. Get transaction ID from response\n// Response: {\"object_id\": \"txn_123\", \"status\": \"QUEUED\"}\n\n// 3. Poll using transactions-get until done\n// Use: mcp_shippo-node_transactions-get with TransactionId\n// Keep checking until status changes from \"QUEUED\" to \"SUCCESS\"\n\n// 4. Once SUCCESS: label_url, tracking_number will be populated\n\\`\\`\\`\n\n**Status Flow:**\n- \\`QUEUED\\` → Processing (keep polling)\n- \\`SUCCESS\\` → ✅ Label ready! Check label_url and tracking_number\n- \\`ERROR\\` → ❌ Check messages for details\n"
+      "description": "Creates a shipping label by purchasing an existing rate.\n\n**IMPORTANT:** The request parameter must be a JSON object, not a string.\n\n**Usage:**\nThis tool creates shipping labels by purchasing existing rates from shipments.\nFirst create a shipment to get rates, then use this tool with the rate ID.\n\n**Required Format:**\n\\`\\`\\`json\n{\n  \"rate\": \"rate_id_here\"\n}\n\\`\\`\\`\n\n**Working Example:**\n\\`\\`\\`json\n{\n  \"rate\": \"b3b719ce08754a249a1fc20db7a61f4b\",\n  \"async\": false\n}\n\\`\\`\\`\n\n**INTERNATIONAL SHIPMENTS - CRITICAL NOTES:**\n- **ALWAYS use \\`async: true\\` for international shipments** to avoid timeouts\n- **Server load can cause 500/504 errors** - retry with async processing\n- **Customs declaration must be attached to shipment** before label creation\n\n**International Example:**\n\\`\\`\\`json\n{\n  \"rate\": \"international_rate_id\",\n  \"async\": true\n}\n\\`\\`\\`\n\n**Error Handling:**\n- If you get 504 Gateway timeout → Use \\`async: true\\`\n- If you get 500 Internal Server Error → Retry with \\`async: true\\`\n- If customs error → Ensure shipment has valid customs_declaration\n\n**Optional Parameters:**\n- \\`async\\`: **Set to true for international** (default: false)\n- \\`label_file_type\\`: PDF_4x6, PNG, etc.\n- \\`metadata\\`: Custom metadata string\n- \\`order\\`: Order ID reference\n\n**Workflow:**\n1. Create shipment → Get rates\n2. **For international: Attach customs declaration**\n3. Choose rate → Use this tool with rate ID\n4. **For international: Use async=true**\n5. **If async: Poll transaction status until complete**\n\n**Async Processing Pattern:**\n\\`\\`\\`javascript\n// 1. Create async transaction\n{\"rate\": \"rate_id\", \"async\": true}\n\n// 2. Get transaction ID from response\n// Response: {\"object_id\": \"txn_123\", \"status\": \"QUEUED\"}\n\n// 3. Poll using transactions-get until done\n// Use: mcp_shippo-node_transactions-get with TransactionId\n// Keep checking until status changes from \"QUEUED\" to \"SUCCESS\"\n\n// 4. Once SUCCESS: label_url, tracking_number will be populated\n\\`\\`\\`\n\n**Status Flow:**\n- \\`QUEUED\\` → Processing (keep polling)\n- \\`SUCCESS\\` → ✅ Label ready! Check label_url and tracking_number\n- \\`ERROR\\` → ❌ Check messages for details\n\n**⚠️ URL HANDLING - CRITICAL:**\nWhen transaction succeeds, the response includes:\n- \\`label_url\\`: S3 signed URL for shipping label download\n- \\`qr_code_url\\`: QR code image URL (if requested)\n- \\`tracking_url_provider\\`: Carrier's tracking page URL\n\n**When displaying these URLs:**\n- ALWAYS show the COMPLETE URL - NEVER truncate or replace parts with \"...\"\n- S3 signed URLs contain required query parameters (Signature, Expires, AWSAccessKeyId)\n- Truncating these URLs will make them non-functional\n- Display URLs in a code block AND as a clickable hyperlink\n"
     },
     {
       "name": "transactions-get",
-      "description": "Retrieve a shipping label transaction by its ID.\n\n**PRIMARY USE: Polling async transaction status**\n\n**Async Transaction Polling Pattern:**\n\\`\\`\\`javascript\n// After creating async transaction, poll until complete:\n\n// 1. Create async transaction → Get transaction_id\n// 2. Poll this endpoint until status != \"QUEUED\"\n\n// Poll example:\n{TransactionId: \"5bd872675aee4e7fb19f961d319fac44\"}\n\\`\\`\\`\n\n**Transaction Status Values:**\n- \\`QUEUED\\` → Still processing (keep polling)\n- \\`SUCCESS\\` → ✅ Label ready! Check response for:\n  - \\`label_url\\`: Download link for shipping label\n  - \\`tracking_number\\`: Package tracking number  \n  - \\`tracking_url_provider\\`: Carrier tracking URL\n- \\`ERROR\\` → ❌ Failed (check \\`messages\\` field for details)\n\n**Polling Best Practice:**\n- Poll every 2-3 seconds until status changes\n- International shipments typically take 10-30 seconds\n- Domestic shipments typically take 2-5 seconds\n\n**Required Parameter:**\n- \\`TransactionId\\`: The transaction object ID from transaction creation\n"
+      "description": "Retrieve a shipping label transaction by its ID.\n\n**PRIMARY USE: Polling async transaction status**\n\n**Async Transaction Polling Pattern:**\n\\`\\`\\`javascript\n// After creating async transaction, poll until complete:\n\n// 1. Create async transaction → Get transaction_id\n// 2. Poll this endpoint until status != \"QUEUED\"\n\n// Poll example:\n{TransactionId: \"5bd872675aee4e7fb19f961d319fac44\"}\n\\`\\`\\`\n\n**Transaction Status Values:**\n- \\`QUEUED\\` → Still processing (keep polling)\n- \\`SUCCESS\\` → ✅ Label ready! Check response for:\n  - \\`label_url\\`: Download link for shipping label\n  - \\`tracking_number\\`: Package tracking number  \n  - \\`tracking_url_provider\\`: Carrier tracking URL\n- \\`ERROR\\` → ❌ Failed (check \\`messages\\` field for details)\n\n**Polling Best Practice:**\n- Poll every 2-3 seconds until status changes\n- International shipments typically take 10-30 seconds\n- Domestic shipments typically take 2-5 seconds\n\n**Required Parameter:**\n- \\`TransactionId\\`: The transaction object ID from transaction creation\n\n**⚠️ URL HANDLING - CRITICAL:**\nWhen displaying URLs from this response (label_url, qr_code_url, tracking_url_provider):\n- ALWAYS show the COMPLETE URL - NEVER truncate or replace parts with \"...\"\n- These are S3 signed URLs with required query parameters (Signature, Expires, AWSAccessKeyId)\n- Truncating these URLs will make them non-functional\n- Display URLs in a code block AND as a clickable hyperlink\n"
     },
     {
       "name": "user-parcel-templates-list",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@shippo/shippo-mcp",
-  "version": "0.8.39",
+  "version": "0.8.48",
   "author": "shippo",
   "type": "module",
   "sideEffects": false,

package/src/funcs/batchesCreate.ts

@@ -35,6 +35,15 @@ import { Result } from "../types/fp.js";
  *
  * @remarks
  * Creates a new batch object for purchasing shipping labels for many shipments at once. Batches are created asynchronously. This means that the API response won't include your batch shipments yet. You need to retrieve the batch later to verify that all batch shipments are valid.
+ *
+ * **IMPORTANT: There is NO batches-list endpoint in the Shippo API.**
+ * You must store the batch `object_id` returned from this endpoint to retrieve batches later using `batches-get`.
+ *
+ * **Workflow:**
+ * 1. Create batch → Save the returned `object_id`
+ * 2. Retrieve batch status using `batches-get` with the saved ID
+ * 3. Add/remove shipments as needed
+ * 4. Purchase the batch when ready
  */
 export function batchesCreate(
   client$: ShippoSDKCore,

package/src/funcs/batchesGet.ts

@@ -32,10 +32,15 @@ import { Result } from "../types/fp.js";
  * Retrieve a batch
  *
  * @remarks
- * Returns a batch using an object ID. <br> Batch shipments are displayed 100 at a time.  You can iterate
- * through each `page` using the `?page= query` parameter.  You can also filter based on batch shipment
- * status, for example, by passing a query param like `?object_results=creation_failed`. <br>
- * For more details on filtering results, see our guide on <a href="https://docs.goshippo.com/docs/api_concepts/filtering/" target="blank"> filtering</a>.
+ * Returns a batch using an object ID. Batch shipments are displayed 100 at a time. You can iterate through each `page` using the `?page=` query parameter. You can also filter based on batch shipment status, for example, by passing a query param like `?object_results=creation_failed`.
+ *
+ * **IMPORTANT: There is NO batches-list endpoint in the Shippo API.**
+ * You must know the batch `object_id` (returned when you created the batch) to retrieve it.
+ * Store batch IDs when creating batches if you need to access them later.
+ *
+ * **URL HANDLING:** This response contains `label_url` (array of download URLs).
+ * When displaying URLs, ALWAYS show the complete URL without truncation.
+ * Never replace parts with "..." - S3 signed URLs will break if truncated.
  */
 export function batchesGet(
   client$: ShippoSDKCore,

package/src/lib/config.ts

@@ -67,8 +67,8 @@ export function serverURLFromOptions(options: SDKOptions): URL | null {
 export const SDK_METADATA = {
   language: "typescript",
   openapiDocVersion: "2018-02-08",
-  sdkVersion: "0.8.39",
+  sdkVersion: "0.8.48",
   genVersion: "2.770.0",
   userAgent:
-    "speakeasy-sdk/mcp-typescript 0.8.39 2.770.0 2018-02-08 @shippo/shippo-mcp",
+    "speakeasy-sdk/mcp-typescript 0.8.48 2.770.0 2018-02-08 @shippo/shippo-mcp",
 } as const;

package/src/mcp-server/mcp-server.ts

@@ -19,7 +19,7 @@ const routes = buildRouteMap({
 export const app = buildApplication(routes, {
   name: "mcp",
   versionInfo: {
-    currentVersion: "0.8.39",
+    currentVersion: "0.8.48",
   },
 });
 

package/src/mcp-server/server.ts

@@ -96,7 +96,7 @@ export function createMCPServer(deps: {
 }) {
   const server = new McpServer({
     name: "ShippoSDK",
-    version: "0.8.39",
+    version: "0.8.48",
   });
 
   const getClient = deps.getSDK || (() =>

package/src/mcp-server/tools/batchesCreate.ts

@@ -14,7 +14,17 @@ export const tool$batchesCreate: ToolDefinition<typeof args> = {
   name: "batches-create",
   description: `Create a batch
 
-Creates a new batch object for purchasing shipping labels for many shipments at once. Batches are created asynchronously. This means that the API response won't include your batch shipments yet. You need to retrieve the batch later to verify that all batch shipments are valid.`,
+Creates a new batch object for purchasing shipping labels for many shipments at once. Batches are created asynchronously. This means that the API response won't include your batch shipments yet. You need to retrieve the batch later to verify that all batch shipments are valid.
+
+**IMPORTANT: There is NO batches-list endpoint in the Shippo API.**
+You must store the batch \`object_id\` returned from this endpoint to retrieve batches later using \`batches-get\`.
+
+**Workflow:**
+1. Create batch → Save the returned \`object_id\`
+2. Retrieve batch status using \`batches-get\` with the saved ID
+3. Add/remove shipments as needed
+4. Purchase the batch when ready
+`,
   annotations: {
     "title": "",
     "destructiveHint": false,

package/src/mcp-server/tools/batchesGet.ts

@@ -14,10 +14,16 @@ export const tool$batchesGet: ToolDefinition<typeof args> = {
   name: "batches-get",
   description: `Retrieve a batch
 
-Returns a batch using an object ID. <br> Batch shipments are displayed 100 at a time.  You can iterate 
-through each \`page\` using the \`?page= query\` parameter.  You can also filter based on batch shipment 
-status, for example, by passing a query param like \`?object_results=creation_failed\`. <br> 
-For more details on filtering results, see our guide on <a href="https://docs.goshippo.com/docs/api_concepts/filtering/" target="blank"> filtering</a>.`,
+Returns a batch using an object ID. Batch shipments are displayed 100 at a time. You can iterate through each \`page\` using the \`?page=\` query parameter. You can also filter based on batch shipment status, for example, by passing a query param like \`?object_results=creation_failed\`.
+
+**IMPORTANT: There is NO batches-list endpoint in the Shippo API.**
+You must know the batch \`object_id\` (returned when you created the batch) to retrieve it.
+Store batch IDs when creating batches if you need to access them later.
+
+**URL HANDLING:** This response contains \`label_url\` (array of download URLs).
+When displaying URLs, ALWAYS show the complete URL without truncation.
+Never replace parts with "..." - S3 signed URLs will break if truncated.
+`,
   annotations: {
     "title": "",
     "destructiveHint": false,

package/src/mcp-server/tools/manifestsGet.ts

@@ -12,15 +12,22 @@ const args = {
 
 export const tool$manifestsGet: ToolDefinition<typeof args> = {
   name: "manifests-get",
-  description: `Retrieve a manifest
+  description: `Returns an existing manifest using an object ID.
 
-Returns an existing manifest using an object ID.`,
+**⚠️ URL HANDLING - CRITICAL:**
+The manifest contains a \`documents\` field with URLs to scan form PDFs.
+When displaying these URLs:
+- ALWAYS show the COMPLETE URL - NEVER truncate or replace parts with "..."
+- These are S3 signed URLs that break if modified
+- Display URLs in a code block AND as a clickable hyperlink
+`,
+  scopes: ["read"],
   annotations: {
     "title": "",
     "destructiveHint": false,
     "idempotentHint": false,
     "openWorldHint": false,
-    "readOnlyHint": true,
+    "readOnlyHint": false,
   },
   args,
   tool: async (client, args, ctx) => {

package/src/mcp-server/tools/manifestsList.ts

@@ -12,15 +12,22 @@ const args = {
 
 export const tool$manifestsList: ToolDefinition<typeof args> = {
   name: "manifests-list",
-  description: `List all manifests
+  description: `Returns a list of all manifest objects.
 
-Returns a list of all manifest objects.`,
+**⚠️ URL HANDLING - CRITICAL:**
+Each manifest contains a \`documents\` field with URLs to scan form PDFs.
+When displaying these URLs:
+- ALWAYS show the COMPLETE URL - NEVER truncate or replace parts with "..."
+- These are S3 signed URLs that break if modified
+- Display URLs in a code block AND as a clickable hyperlink
+`,
+  scopes: ["read"],
   annotations: {
     "title": "",
     "destructiveHint": false,
     "idempotentHint": false,
     "openWorldHint": false,
-    "readOnlyHint": true,
+    "readOnlyHint": false,
   },
   args,
   tool: async (client, args, ctx) => {

package/src/mcp-server/tools/trackingStatusGet.ts

@@ -36,6 +36,11 @@ not the actual carrier names like 'USPS', 'UPS', 'FedEx', etc.
 \`\`\`
 
 The API will return an error if you use real carrier names with test tokens.
+
+**⚠️ URL HANDLING - CRITICAL:**
+The response may include tracking URLs. When displaying any URLs:
+- ALWAYS show the COMPLETE URL - NEVER truncate or replace parts with "..."
+- Display URLs in a code block AND as a clickable hyperlink
 `,
   scopes: ["read", "tracking"],
   annotations: {

package/src/mcp-server/tools/transactionsCreate.ts

@@ -85,6 +85,18 @@ First create a shipment to get rates, then use this tool with the rate ID.
 - \`QUEUED\` → Processing (keep polling)
 - \`SUCCESS\` → ✅ Label ready! Check label_url and tracking_number
 - \`ERROR\` → ❌ Check messages for details
+
+**⚠️ URL HANDLING - CRITICAL:**
+When transaction succeeds, the response includes:
+- \`label_url\`: S3 signed URL for shipping label download
+- \`qr_code_url\`: QR code image URL (if requested)
+- \`tracking_url_provider\`: Carrier's tracking page URL
+
+**When displaying these URLs:**
+- ALWAYS show the COMPLETE URL - NEVER truncate or replace parts with "..."
+- S3 signed URLs contain required query parameters (Signature, Expires, AWSAccessKeyId)
+- Truncating these URLs will make them non-functional
+- Display URLs in a code block AND as a clickable hyperlink
 `,
   scopes: ["write"],
   annotations: {

package/src/mcp-server/tools/transactionsGet.ts

@@ -42,6 +42,13 @@ export const tool$transactionsGet: ToolDefinition<typeof args> = {
 
 **Required Parameter:**
 - \`TransactionId\`: The transaction object ID from transaction creation
+
+**⚠️ URL HANDLING - CRITICAL:**
+When displaying URLs from this response (label_url, qr_code_url, tracking_url_provider):
+- ALWAYS show the COMPLETE URL - NEVER truncate or replace parts with "..."
+- These are S3 signed URLs with required query parameters (Signature, Expires, AWSAccessKeyId)
+- Truncating these URLs will make them non-functional
+- Display URLs in a code block AND as a clickable hyperlink
 `,
   scopes: ["read"],
   annotations: {

package/src/mcp-server/tools/transactionsList.ts

@@ -45,6 +45,13 @@ This tool lists transaction objects, which represent purchased shipping labels.
 
 **Note on Test Mode:**
 Test transactions will always show \`tracking_status: "UNKNOWN"\` because they don't receive real carrier tracking updates.
+
+**⚠️ URL HANDLING - CRITICAL:**
+Each transaction may include URLs (label_url, qr_code_url, tracking_url_provider).
+When displaying these URLs:
+- ALWAYS show the COMPLETE URL - NEVER truncate or replace parts with "..."
+- These are S3 signed URLs that break if modified
+- Display URLs in a code block AND as a clickable hyperlink
 `,
   scopes: ["read"],
   annotations: {

package/src/models/order.ts

@@ -4,6 +4,10 @@
 
 import * as z from "zod";
 import { Address, Address$zodSchema } from "./address.js";
+import {
+  AddressValidationResults,
+  AddressValidationResults$zodSchema,
+} from "./addressvalidationresults.js";
 import { LineItem, LineItem$zodSchema } from "./lineitem.js";
 import {
   OrderShopAppEnum,
@@ -15,6 +19,63 @@ import {
 } from "./orderstatusenum.js";
 import { WeightUnitEnum, WeightUnitEnum$zodSchema } from "./weightunitenum.js";
 
+/**
+ * <a href="#tag/Addresses">Address</a> object of the sender / seller. Will be returned expanded by default.
+ */
+export type OrderAddressFrom = {
+  name?: string | undefined;
+  company?: string | undefined;
+  street1?: string | undefined;
+  street2?: string | undefined;
+  street3?: string | undefined;
+  street_no?: string | undefined;
+  city?: string | undefined;
+  state?: string | undefined;
+  zip?: string | undefined;
+  country: string;
+  phone?: string | undefined;
+  email?: string | undefined;
+  is_residential?: boolean | null | undefined;
+  metadata?: string | undefined;
+  is_complete?: boolean | undefined;
+  object_created?: string | undefined;
+  object_id?: string | undefined;
+  object_owner?: string | undefined;
+  object_updated?: string | undefined;
+  validation_results?: AddressValidationResults | undefined;
+  test?: boolean | null | undefined;
+};
+
+export const OrderAddressFrom$zodSchema: z.ZodType<
+  OrderAddressFrom,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  city: z.string().optional(),
+  company: z.string().optional(),
+  country: z.string(),
+  email: z.string().optional(),
+  is_complete: z.boolean().optional(),
+  is_residential: z.boolean().nullable().optional(),
+  metadata: z.string().optional(),
+  name: z.string().optional(),
+  object_created: z.string().datetime({ offset: true }).optional(),
+  object_id: z.string().optional(),
+  object_owner: z.string().optional(),
+  object_updated: z.string().datetime({ offset: true }).optional(),
+  phone: z.string().optional(),
+  state: z.string().optional(),
+  street1: z.string().optional(),
+  street2: z.string().optional(),
+  street3: z.string().optional(),
+  street_no: z.string().optional(),
+  test: z.boolean().nullable().optional(),
+  validation_results: AddressValidationResults$zodSchema.optional(),
+  zip: z.string().optional(),
+}).describe(
+  "<a href=\"#tag/Addresses\">Address</a> object of the sender / seller. Will be returned expanded by default.",
+);
+
 export type OrderTransaction = {};
 
 export const OrderTransaction$zodSchema: z.ZodType<
@@ -24,20 +85,20 @@ export const OrderTransaction$zodSchema: z.ZodType<
 > = z.object({});
 
 export type Order = {
-  currency?: string | undefined;
-  notes?: string | undefined;
-  order_number?: string | undefined;
+  currency?: string | null | undefined;
+  notes?: string | null | undefined;
+  order_number?: string | null | undefined;
   order_status?: OrderStatusEnum | undefined;
   placed_at: string;
-  shipping_cost?: string | undefined;
-  shipping_cost_currency?: string | undefined;
-  shipping_method?: string | undefined;
-  subtotal_price?: string | undefined;
-  total_price?: string | undefined;
-  total_tax?: string | undefined;
-  weight?: string | undefined;
+  shipping_cost?: string | null | undefined;
+  shipping_cost_currency?: string | null | undefined;
+  shipping_method?: string | null | undefined;
+  subtotal_price?: string | null | undefined;
+  total_price?: string | null | undefined;
+  total_tax?: string | null | undefined;
+  weight?: string | null | undefined;
   weight_unit?: WeightUnitEnum | undefined;
-  from_address?: Address | undefined;
+  from_address?: OrderAddressFrom | null | undefined;
   to_address: Address;
   line_items?: Array<LineItem> | undefined;
   object_id?: string | undefined;
@@ -48,24 +109,25 @@ export type Order = {
 
 export const Order$zodSchema: z.ZodType<Order, z.ZodTypeDef, unknown> = z
   .object({
-    currency: z.string().optional(),
-    from_address: Address$zodSchema.optional(),
+    currency: z.string().nullable().optional(),
+    from_address: z.lazy(() => OrderAddressFrom$zodSchema).nullable()
+      .optional(),
     line_items: z.array(LineItem$zodSchema).optional(),
-    notes: z.string().optional(),
+    notes: z.string().nullable().optional(),
     object_id: z.string().optional(),
     object_owner: z.string().optional(),
-    order_number: z.string().optional(),
+    order_number: z.string().nullable().optional(),
     order_status: OrderStatusEnum$zodSchema.optional(),
     placed_at: z.string(),
-    shipping_cost: z.string().optional(),
-    shipping_cost_currency: z.string().optional(),
-    shipping_method: z.string().optional(),
+    shipping_cost: z.string().nullable().optional(),
+    shipping_cost_currency: z.string().nullable().optional(),
+    shipping_method: z.string().nullable().optional(),
     shop_app: OrderShopAppEnum$zodSchema.optional(),
-    subtotal_price: z.string().optional(),
+    subtotal_price: z.string().nullable().optional(),
     to_address: Address$zodSchema,
-    total_price: z.string().optional(),
-    total_tax: z.string().optional(),
+    total_price: z.string().nullable().optional(),
+    total_tax: z.string().nullable().optional(),
     transactions: z.array(z.lazy(() => OrderTransaction$zodSchema)).optional(),
-    weight: z.string().optional(),
+    weight: z.string().nullable().optional(),
     weight_unit: WeightUnitEnum$zodSchema.optional(),
   });

package/src/models/ordercreaterequest.ts

@@ -15,18 +15,18 @@ import {
 import { WeightUnitEnum, WeightUnitEnum$zodSchema } from "./weightunitenum.js";
 
 export type OrderCreateRequest = {
-  currency?: string | undefined;
-  notes?: string | undefined;
-  order_number?: string | undefined;
+  currency?: string | null | undefined;
+  notes?: string | null | undefined;
+  order_number?: string | null | undefined;
   order_status?: OrderStatusEnum | undefined;
   placed_at: string;
-  shipping_cost?: string | undefined;
-  shipping_cost_currency?: string | undefined;
-  shipping_method?: string | undefined;
-  subtotal_price?: string | undefined;
-  total_price?: string | undefined;
-  total_tax?: string | undefined;
-  weight?: string | undefined;
+  shipping_cost?: string | null | undefined;
+  shipping_cost_currency?: string | null | undefined;
+  shipping_method?: string | null | undefined;
+  subtotal_price?: string | null | undefined;
+  total_price?: string | null | undefined;
+  total_tax?: string | null | undefined;
+  weight?: string | null | undefined;
   weight_unit?: WeightUnitEnum | undefined;
   from_address?: AddressCreateRequest | undefined;
   to_address: AddressCreateRequest;
@@ -38,20 +38,20 @@ export const OrderCreateRequest$zodSchema: z.ZodType<
   z.ZodTypeDef,
   unknown
 > = z.object({
-  currency: z.string().optional(),
+  currency: z.string().nullable().optional(),
   from_address: AddressCreateRequest$zodSchema.optional(),
   line_items: z.array(LineItemBase$zodSchema).optional(),
-  notes: z.string().optional(),
-  order_number: z.string().optional(),
+  notes: z.string().nullable().optional(),
+  order_number: z.string().nullable().optional(),
   order_status: OrderStatusEnum$zodSchema.optional(),
   placed_at: z.string(),
-  shipping_cost: z.string().optional(),
-  shipping_cost_currency: z.string().optional(),
-  shipping_method: z.string().optional(),
-  subtotal_price: z.string().optional(),
+  shipping_cost: z.string().nullable().optional(),
+  shipping_cost_currency: z.string().nullable().optional(),
+  shipping_method: z.string().nullable().optional(),
+  subtotal_price: z.string().nullable().optional(),
   to_address: AddressCreateRequest$zodSchema,
-  total_price: z.string().optional(),
-  total_tax: z.string().optional(),
-  weight: z.string().optional(),
+  total_price: z.string().nullable().optional(),
+  total_tax: z.string().nullable().optional(),
+  weight: z.string().nullable().optional(),
   weight_unit: WeightUnitEnum$zodSchema.optional(),
 });