@shippo/shippo-mcp 0.5.0

package/src/models/servicelevelupsenum.ts

@@ -0,0 +1,95 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+
+/**
+ * |Token | Service name|
+ *
+ * @remarks
+ * |:---|:---|
+ * | ups_standard | Standardâ„ |
+ * | ups_ground | Ground|
+ * | ups_saver | Saver®|
+ * | ups_3_day_select | 3 Day Select®|
+ * | ups_second_day_air | 2nd Day Air®|
+ * | ups_second_day_air_am | 2nd Day Air® A.M.|
+ * | ups_next_day_air | Next Day Air®|
+ * | ups_next_day_air_saver | Next Day Air Saver®|
+ * | ups_next_day_air_early_am | Next Day Air® Early|
+ * | ups_mail_innovations_bpm_flat | Mail Innovations BPM Flat |
+ * | ups_mail_innovations_bpm_parcel | Mail Innovations BPM Parcel |
+ * | ups_mail_innovations_irregular | Mail Innovations Irregular |
+ * | ups_mail_innovations_media_mail | Mail Innovations Media Mail |
+ * | ups_mail_innovations_parcel | Mail Innovations Parcel |
+ * | ups_mail_innovations_standard_flat | Mail Innovations Standard Flat |
+ * | ups_surepost | Surepost|
+ * | ups_surepost_bound_printed_matter | SurePost® Bound Printed Matter|
+ * | ups_surepost_lightweight | Surepost Lightweight|
+ * | ups_surepost_media | SurePost® Media|
+ * | ups_express | Express®|
+ * | ups_express_1200 | Express 12:00|
+ * | ups_express_plus | Express Plus®|
+ * | ups_expedited | Expedited®|
+ * | ups_express_early | Express® Early|
+ * | ups_access_point_economy | Access Pointâ„¢ Economy|
+ */
+export const ServiceLevelUPSEnum$zodSchema = z.enum([
+  "ups_standard",
+  "ups_ground",
+  "ups_saver",
+  "ups_3_day_select",
+  "ups_second_day_air",
+  "ups_second_day_air_am",
+  "ups_next_day_air",
+  "ups_next_day_air_saver",
+  "ups_next_day_air_early_am",
+  "ups_mail_innovations_bpm_flat",
+  "ups_mail_innovations_bpm_parcel",
+  "ups_mail_innovations_irregular",
+  "ups_mail_innovations_media_mail",
+  "ups_mail_innovations_parcel",
+  "ups_mail_innovations_standard_flat",
+  "ups_surepost",
+  "ups_surepost_bound_printed_matter",
+  "ups_surepost_lightweight",
+  "ups_surepost_media",
+  "ups_express",
+  "ups_express_1200",
+  "ups_express_plus",
+  "ups_expedited",
+  "ups_express_early",
+  "ups_access_point_economy",
+]).describe(
+  "|Token | Service name|\n"
+    + "|:---|:---|\n"
+    + "| ups_standard | Standardâ„ |\n"
+    + "| ups_ground | Ground|\n"
+    + "| ups_saver | Saver®|\n"
+    + "| ups_3_day_select | 3 Day Select®|\n"
+    + "| ups_second_day_air | 2nd Day Air®|\n"
+    + "| ups_second_day_air_am | 2nd Day Air® A.M.|\n"
+    + "| ups_next_day_air | Next Day Air®|\n"
+    + "| ups_next_day_air_saver | Next Day Air Saver®|\n"
+    + "| ups_next_day_air_early_am | Next Day Air® Early|\n"
+    + "| ups_mail_innovations_bpm_flat | Mail Innovations BPM Flat |\n"
+    + "| ups_mail_innovations_bpm_parcel | Mail Innovations BPM Parcel |\n"
+    + "| ups_mail_innovations_irregular | Mail Innovations Irregular |\n"
+    + "| ups_mail_innovations_media_mail | Mail Innovations Media Mail |\n"
+    + "| ups_mail_innovations_parcel | Mail Innovations Parcel |\n"
+    + "| ups_mail_innovations_standard_flat | Mail Innovations Standard Flat |\n"
+    + "| ups_surepost | Surepost|\n"
+    + "| ups_surepost_bound_printed_matter | SurePost® Bound Printed Matter|\n"
+    + "| ups_surepost_lightweight | Surepost Lightweight|\n"
+    + "| ups_surepost_media | SurePost® Media|\n"
+    + "| ups_express | Express®|\n"
+    + "| ups_express_1200 | Express 12:00|\n"
+    + "| ups_express_plus | Express Plus®|\n"
+    + "| ups_expedited | Expedited®|\n"
+    + "| ups_express_early | Express® Early|\n"
+    + "| ups_access_point_economy | Access Pointâ„¢ Economy|\n"
+    + "",
+);
+
+export type ServiceLevelUPSEnum = z.infer<typeof ServiceLevelUPSEnum$zodSchema>;

package/src/models/serviceleveluspsenum.ts

@@ -0,0 +1,43 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+
+/**
+ * |Token | Service name|
+ *
+ * @remarks
+ * |:---|:---|
+ * | usps_priority | Priority Mail|
+ * | usps_priority_express | Priority Mail Express|
+ * | usps_media_mail | Media Mail, only for existing Shippo customers with grandfathered Media Mail option.|
+ * | usps_priority_mail_international | Priority Mail International|
+ * | usps_priority_mail_express_international | Priority Mail Express International|
+ * | usps_first_class_package_international_service | First Class Package International|
+ * | usps_ground_advantage | Ground Advantage |
+ */
+export const ServiceLevelUSPSEnum$zodSchema = z.enum([
+  "usps_priority",
+  "usps_priority_express",
+  "usps_media_mail",
+  "usps_priority_mail_international",
+  "usps_priority_mail_express_international",
+  "usps_first_class_package_international_service",
+  "usps_ground_advantage",
+]).describe(
+  "|Token | Service name|\n"
+    + "|:---|:---|\n"
+    + "| usps_priority | Priority Mail|\n"
+    + "| usps_priority_express | Priority Mail Express|\n"
+    + "| usps_media_mail | Media Mail, only for existing Shippo customers with grandfathered Media Mail option.|\n"
+    + "| usps_priority_mail_international | Priority Mail International|\n"
+    + "| usps_priority_mail_express_international | Priority Mail Express International|\n"
+    + "| usps_first_class_package_international_service | First Class Package International|\n"
+    + "| usps_ground_advantage | Ground Advantage |\n"
+    + "",
+);
+
+export type ServiceLevelUSPSEnum = z.infer<
+  typeof ServiceLevelUSPSEnum$zodSchema
+>;

package/src/models/servicelevelvehoenum.ts

@@ -0,0 +1,28 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+
+/**
+ * |Token | Service name|
+ *
+ * @remarks
+ * |:---|:---|
+ * | veho_ground_plus | Veho Ground Plus |
+ * | veho_premium_economy | Veho Premium Economy
+ */
+export const ServiceLevelVehoEnum$zodSchema = z.enum([
+  "veho_ground_plus",
+  "veho_premium_economy",
+]).describe(
+  "|Token | Service name|\n"
+    + "|:---|:---|\n"
+    + "| veho_ground_plus | Veho Ground Plus |\n"
+    + "| veho_premium_economy | Veho Premium Economy\n"
+    + "",
+);
+
+export type ServiceLevelVehoEnum = z.infer<
+  typeof ServiceLevelVehoEnum$zodSchema
+>;

package/src/models/servicelevelwithparent.ts

@@ -0,0 +1,60 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+
+/**
+ * Used for some Service Levels to link to the more "generic" version of this Service Level - for example,
+ *
+ * @remarks
+ * if this Service Level is a variation specific to shipments to Europe("ups_saver_eu"), the "parent" is
+ * the fully generic version ("ups_saver"). Helpful when displaying Service Levels to users. Has the same
+ * structure of the servicelevel - "name", "token", "terms", and "extended_token", or it is otherwise null.
+ */
+export type ParentServicelevel = {
+  name?: string | undefined;
+  terms?: string | undefined;
+  token?: string | undefined;
+  extended_token?: string | undefined;
+};
+
+export const ParentServicelevel$zodSchema: z.ZodType<
+  ParentServicelevel,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  extended_token: z.string().optional(),
+  name: z.string().optional(),
+  terms: z.string().optional(),
+  token: z.string().optional(),
+}).describe(
+  "Used for some Service Levels to link to the more \"generic\" version of this Service Level - for example, \n"
+    + "if this Service Level is a variation specific to shipments to Europe(\"ups_saver_eu\"), the \"parent\" is \n"
+    + "the fully generic version (\"ups_saver\"). Helpful when displaying Service Levels to users. Has the same \n"
+    + "structure of the servicelevel - \"name\", \"token\", \"terms\", and \"extended_token\", or it is otherwise null.",
+);
+
+/**
+ * Contains details regarding the service level for the given rate.
+ */
+export type ServiceLevelWithParent = {
+  name?: string | undefined;
+  terms?: string | undefined;
+  token?: string | undefined;
+  extended_token?: string | undefined;
+  parent_servicelevel?: ParentServicelevel | null | undefined;
+};
+
+export const ServiceLevelWithParent$zodSchema: z.ZodType<
+  ServiceLevelWithParent,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  extended_token: z.string().optional(),
+  name: z.string().optional(),
+  parent_servicelevel: z.lazy(() => ParentServicelevel$zodSchema).nullable()
+    .optional(),
+  terms: z.string().optional(),
+  token: z.string().optional(),
+}).describe("Contains details regarding the service level for the given rate.");

package/src/models/shipment.ts

@@ -0,0 +1,83 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import { Address, Address$zodSchema } from "./address.js";
+import {
+  CustomsDeclaration,
+  CustomsDeclaration$zodSchema,
+} from "./customsdeclarationcreaterequest.js";
+import { Parcel, Parcel$zodSchema } from "./parcel.js";
+import { Rate, Rate$zodSchema } from "./rate.js";
+import {
+  ResponseMessage,
+  ResponseMessage$zodSchema,
+} from "./responsemessage.js";
+import { ShipmentExtra, ShipmentExtra$zodSchema } from "./shipmentextra.js";
+
+/**
+ * `Waiting` shipments have been successfully submitted but not yet been processed.
+ *
+ * @remarks
+ * `Queued` shipments are currently being processed.
+ * `Success` shipments have been processed successfully, meaning that rate generation has concluded.
+ * `Error` does not occur currently and is reserved for future use.
+ */
+export const ShipmentStatus$zodSchema = z.enum([
+  "ERROR",
+  "QUEUED",
+  "SUCCESS",
+  "WAITING",
+]).describe(
+  "`Waiting` shipments have been successfully submitted but not yet been processed. \n"
+    + "`Queued` shipments are currently being processed. \n"
+    + "`Success` shipments have been processed successfully, meaning that rate generation has concluded. \n"
+    + "`Error` does not occur currently and is reserved for future use.",
+);
+
+export type ShipmentStatus = z.infer<typeof ShipmentStatus$zodSchema>;
+
+/**
+ * Shipment represents the parcel as retrieved from the database
+ */
+export type Shipment = {
+  extra?: ShipmentExtra | undefined;
+  metadata: string;
+  shipment_date?: string | undefined;
+  address_from: Address;
+  address_return?: Address | undefined;
+  address_to: Address;
+  carrier_accounts: Array<string>;
+  customs_declaration?: CustomsDeclaration | null | undefined;
+  messages: Array<ResponseMessage>;
+  object_created: string;
+  object_id: string;
+  object_owner: string;
+  object_updated: string;
+  parcels: Array<Parcel> | null;
+  rates: Array<Rate>;
+  status: ShipmentStatus;
+  test?: boolean | undefined;
+};
+
+export const Shipment$zodSchema: z.ZodType<Shipment, z.ZodTypeDef, unknown> = z
+  .object({
+    address_from: Address$zodSchema,
+    address_return: Address$zodSchema.optional(),
+    address_to: Address$zodSchema,
+    carrier_accounts: z.array(z.string()),
+    customs_declaration: CustomsDeclaration$zodSchema.nullable().optional(),
+    extra: ShipmentExtra$zodSchema.optional(),
+    messages: z.array(ResponseMessage$zodSchema),
+    metadata: z.string(),
+    object_created: z.string().datetime({ offset: true }),
+    object_id: z.string(),
+    object_owner: z.string(),
+    object_updated: z.string().datetime({ offset: true }),
+    parcels: z.array(Parcel$zodSchema).nullable(),
+    rates: z.array(Rate$zodSchema),
+    shipment_date: z.string().optional(),
+    status: ShipmentStatus$zodSchema,
+    test: z.boolean().optional(),
+  }).describe("Shipment represents the parcel as retrieved from the database");

package/src/models/shipmentcreaterequest.ts

@@ -0,0 +1,129 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import {
+  AddressCreateRequest,
+  AddressCreateRequest$zodSchema,
+} from "./addresscreaterequest.js";
+import {
+  CustomsDeclarationCreateRequest,
+  CustomsDeclarationCreateRequest$zodSchema,
+} from "./customsdeclarationcreaterequest.js";
+import {
+  ParcelCreateFromTemplateRequest,
+  ParcelCreateFromTemplateRequest$zodSchema,
+} from "./parcelcreatefromtemplaterequest.js";
+import {
+  ParcelCreateRequest,
+  ParcelCreateRequest$zodSchema,
+} from "./parcelcreaterequest.js";
+import { ShipmentExtra, ShipmentExtra$zodSchema } from "./shipmentextra.js";
+
+export type ShipmentCreateRequestAddressFrom = AddressCreateRequest | string;
+
+export const ShipmentCreateRequestAddressFrom$zodSchema: z.ZodType<
+  ShipmentCreateRequestAddressFrom,
+  z.ZodTypeDef,
+  unknown
+> = z.union([
+  AddressCreateRequest$zodSchema,
+  z.string(),
+]);
+
+export type AddressReturn = AddressCreateRequest | string;
+
+export const AddressReturn$zodSchema: z.ZodType<
+  AddressReturn,
+  z.ZodTypeDef,
+  unknown
+> = z.union([
+  AddressCreateRequest$zodSchema,
+  z.string(),
+]);
+
+export type ShipmentCreateRequestAddressTo = AddressCreateRequest | string;
+
+export const ShipmentCreateRequestAddressTo$zodSchema: z.ZodType<
+  ShipmentCreateRequestAddressTo,
+  z.ZodTypeDef,
+  unknown
+> = z.union([
+  AddressCreateRequest$zodSchema,
+  z.string(),
+]);
+
+export type CustomsDeclarationUnion = CustomsDeclarationCreateRequest | string;
+
+export const CustomsDeclarationUnion$zodSchema: z.ZodType<
+  CustomsDeclarationUnion,
+  z.ZodTypeDef,
+  unknown
+> = z.union([
+  CustomsDeclarationCreateRequest$zodSchema,
+  z.string(),
+]);
+
+export type ShipmentCreateRequestParcel =
+  | ParcelCreateFromTemplateRequest
+  | ParcelCreateRequest
+  | string;
+
+export const ShipmentCreateRequestParcel$zodSchema: z.ZodType<
+  ShipmentCreateRequestParcel,
+  z.ZodTypeDef,
+  unknown
+> = z.union([
+  ParcelCreateFromTemplateRequest$zodSchema,
+  ParcelCreateRequest$zodSchema,
+  z.string(),
+]);
+
+export type ShipmentCreateRequest = {
+  extra?: ShipmentExtra | undefined;
+  metadata?: string | undefined;
+  shipment_date?: string | undefined;
+  address_from: AddressCreateRequest | string;
+  address_return?: AddressCreateRequest | string | undefined;
+  address_to: AddressCreateRequest | string;
+  customs_declaration?: CustomsDeclarationCreateRequest | string | undefined;
+  async?: boolean | undefined;
+  carrier_accounts?: Array<string> | undefined;
+  parcels: Array<
+    ParcelCreateFromTemplateRequest | ParcelCreateRequest | string
+  >;
+};
+
+export const ShipmentCreateRequest$zodSchema: z.ZodType<
+  ShipmentCreateRequest,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  address_from: z.union([
+    AddressCreateRequest$zodSchema,
+    z.string(),
+  ]),
+  address_return: z.union([
+    AddressCreateRequest$zodSchema,
+    z.string(),
+  ]).optional(),
+  address_to: z.union([
+    AddressCreateRequest$zodSchema,
+    z.string(),
+  ]),
+  async: z.boolean().optional(),
+  carrier_accounts: z.array(z.string()).optional(),
+  customs_declaration: z.union([
+    CustomsDeclarationCreateRequest$zodSchema,
+    z.string(),
+  ]).optional(),
+  extra: ShipmentExtra$zodSchema.optional(),
+  metadata: z.string().optional(),
+  parcels: z.array(z.union([
+    ParcelCreateFromTemplateRequest$zodSchema,
+    ParcelCreateRequest$zodSchema,
+    z.string(),
+  ])),
+  shipment_date: z.string().optional(),
+});

package/src/models/shipmentextra.ts

@@ -0,0 +1,251 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import { Alcohol, Alcohol$zodSchema } from "./alcohol.js";
+import { Billing, Billing$zodSchema } from "./billing.js";
+import { Cod, Cod$zodSchema } from "./cod.js";
+import {
+  CustomerReference,
+  CustomerReference$zodSchema,
+} from "./customerreference.js";
+import {
+  DangerousGoodsObject,
+  DangerousGoodsObject$zodSchema,
+} from "./dangerousgoodsobject.js";
+import {
+  DepartmentNumber,
+  DepartmentNumber$zodSchema,
+} from "./departmentnumber.js";
+import { DryIce, DryIce$zodSchema } from "./dryice.js";
+import { Insurance, Insurance$zodSchema } from "./insurance.js";
+import { InvoiceNumber, InvoiceNumber$zodSchema } from "./invoicenumber.js";
+import { PoNumber, PoNumber$zodSchema } from "./ponumber.js";
+import { RmaNumber, RmaNumber$zodSchema } from "./rmanumber.js";
+import {
+  ShipmentExtraLasershipAttributesEnum,
+  ShipmentExtraLasershipAttributesEnum$zodSchema,
+} from "./shipmentextralasershipattributesenum.js";
+import {
+  ShipmentExtraReturnServiceTypeLasershipEnum,
+  ShipmentExtraReturnServiceTypeLasershipEnum$zodSchema,
+} from "./shipmentextrareturnservicetypelasershipenum.js";
+import {
+  ShipmentExtraReturnServiceTypeUPSEnum,
+  ShipmentExtraReturnServiceTypeUPSEnum$zodSchema,
+} from "./shipmentextrareturnservicetypeupsenum.js";
+import {
+  UPSReferenceFields,
+  UPSReferenceFields$zodSchema,
+} from "./upsreferencefields.js";
+
+/**
+ * Specify an ancillary service endorsement to provide the USPS with instructions on how to handle undeliverable-as-addressed pieces (DHL eCommerce only).
+ */
+export const AncillaryEndorsement$zodSchema = z.enum([
+  "FORWARDING_SERVICE_REQUESTED",
+  "RETURN_SERVICE_REQUESTED",
+]).describe(
+  "Specify an ancillary service endorsement to provide the USPS with instructions on how to handle undeliverable-as-addressed pieces (DHL eCommerce only).",
+);
+
+export type AncillaryEndorsement = z.infer<
+  typeof AncillaryEndorsement$zodSchema
+>;
+
+/**
+ * Dangerous Goods Code (DHL eCommerce only). See <a href="https://api-legacy.dhlecs.com/docs/v2/appendix.html#dangerous-goods">Category Codes</a>
+ */
+export const DangerousGoodsCode$zodSchema = z.enum([
+  "01",
+  "02",
+  "03",
+  "04",
+  "05",
+  "06",
+  "07",
+  "08",
+  "09",
+]).describe(
+  "Dangerous Goods Code (DHL eCommerce only). See <a href=\"https://api-legacy.dhlecs.com/docs/v2/appendix.html#dangerous-goods\">Category Codes</a>",
+);
+
+export type DangerousGoodsCode = z.infer<typeof DangerousGoodsCode$zodSchema>;
+
+/**
+ * Required for DHL Germany Paket Sameday. Designates a desired timeframe for delivery. Format is `HHMMHHMM`
+ */
+export const PreferredDeliveryTimeframe$zodSchema = z.enum([
+  "10001200",
+  "12001400",
+  "14001600",
+  "16001800",
+  "18002000",
+  "19002100",
+]).describe(
+  "Required for DHL Germany Paket Sameday. Designates a desired timeframe for delivery. Format is `HHMMHHMM`",
+);
+
+export type PreferredDeliveryTimeframe = z.infer<
+  typeof PreferredDeliveryTimeframe$zodSchema
+>;
+
+/**
+ * Request additional return option for return shipments (UPS and Lasership only).
+ */
+export type ReturnServiceType =
+  | ShipmentExtraReturnServiceTypeUPSEnum
+  | ShipmentExtraReturnServiceTypeLasershipEnum;
+
+export const ReturnServiceType$zodSchema: z.ZodType<
+  ReturnServiceType,
+  z.ZodTypeDef,
+  unknown
+> = z.union([
+  ShipmentExtraReturnServiceTypeUPSEnum$zodSchema,
+  ShipmentExtraReturnServiceTypeLasershipEnum$zodSchema,
+]).describe(
+  "Request additional return option for return shipments (UPS and Lasership only).",
+);
+
+/**
+ * Request standard or adult signature confirmation. You can alternatively request Certified Mail (USPS only)
+ *
+ * @remarks
+ * or Indirect signature (FedEx only) or Carrier Confirmation (Deutsche Post only).
+ */
+export const SignatureConfirmation$zodSchema = z.enum([
+  "STANDARD",
+  "ADULT",
+  "CERTIFIED",
+  "INDIRECT",
+  "CARRIER_CONFIRMATION",
+]).describe(
+  "Request standard or adult signature confirmation. You can alternatively request Certified Mail (USPS only) \n"
+    + "or Indirect signature (FedEx only) or Carrier Confirmation (Deutsche Post only).",
+);
+
+export type SignatureConfirmation = z.infer<
+  typeof SignatureConfirmation$zodSchema
+>;
+
+/**
+ * An object holding optional extra services to be requested.
+ */
+export type ShipmentExtra = {
+  accounts_receivable_customer_account?: UPSReferenceFields | undefined;
+  alcohol?: Alcohol | undefined;
+  ancillary_endorsement?: AncillaryEndorsement | undefined;
+  appropriation_number?: UPSReferenceFields | undefined;
+  authority_to_leave?: boolean | undefined;
+  bill_of_lading_number?: UPSReferenceFields | undefined;
+  billing?: Billing | undefined;
+  bypass_address_validation?: boolean | undefined;
+  carbon_neutral?: boolean | undefined;
+  carrier_hub_id?: string | undefined;
+  carrier_hub_travel_time?: number | undefined;
+  COD?: Cod | undefined;
+  cod_number?: UPSReferenceFields | undefined;
+  container_type?: string | undefined;
+  critical_pull_time?: string | undefined;
+  customer_branch?: string | undefined;
+  customer_reference?: CustomerReference | undefined;
+  dangerous_goods?: DangerousGoodsObject | undefined;
+  dangerous_goods_code?: DangerousGoodsCode | undefined;
+  dealer_order_number?: UPSReferenceFields | undefined;
+  delivery_instructions?: string | undefined;
+  dept_number?: DepartmentNumber | undefined;
+  dry_ice?: DryIce | undefined;
+  fda_product_code?: UPSReferenceFields | undefined;
+  fulfillment_center?: string | undefined;
+  insurance?: Insurance | undefined;
+  invoice_number?: InvoiceNumber | undefined;
+  is_return?: boolean | undefined;
+  lasership_attrs?: Array<ShipmentExtraLasershipAttributesEnum> | undefined;
+  lasership_declared_value?: string | undefined;
+  manifest_number?: UPSReferenceFields | undefined;
+  model_number?: UPSReferenceFields | undefined;
+  part_number?: UPSReferenceFields | undefined;
+  po_number?: PoNumber | undefined;
+  preferred_delivery_timeframe?: PreferredDeliveryTimeframe | undefined;
+  premium?: boolean | undefined;
+  production_code?: UPSReferenceFields | undefined;
+  purchase_request_number?: UPSReferenceFields | undefined;
+  qr_code_requested?: boolean | undefined;
+  reference_1?: string | undefined;
+  reference_2?: string | undefined;
+  request_retail_rates?: boolean | undefined;
+  return_service_type?:
+    | ShipmentExtraReturnServiceTypeUPSEnum
+    | ShipmentExtraReturnServiceTypeLasershipEnum
+    | undefined;
+  rma_number?: RmaNumber | undefined;
+  saturday_delivery?: boolean | undefined;
+  salesperson_number?: UPSReferenceFields | undefined;
+  serial_number?: UPSReferenceFields | undefined;
+  signature_confirmation?: SignatureConfirmation | undefined;
+  store_number?: UPSReferenceFields | undefined;
+  transaction_reference_number?: UPSReferenceFields | undefined;
+};
+
+export const ShipmentExtra$zodSchema: z.ZodType<
+  ShipmentExtra,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  COD: Cod$zodSchema.optional(),
+  accounts_receivable_customer_account: UPSReferenceFields$zodSchema.optional(),
+  alcohol: Alcohol$zodSchema.optional(),
+  ancillary_endorsement: AncillaryEndorsement$zodSchema.optional(),
+  appropriation_number: UPSReferenceFields$zodSchema.optional(),
+  authority_to_leave: z.boolean().optional(),
+  bill_of_lading_number: UPSReferenceFields$zodSchema.optional(),
+  billing: Billing$zodSchema.optional(),
+  bypass_address_validation: z.boolean().optional(),
+  carbon_neutral: z.boolean().optional(),
+  carrier_hub_id: z.string().optional(),
+  carrier_hub_travel_time: z.number().int().optional(),
+  cod_number: UPSReferenceFields$zodSchema.optional(),
+  container_type: z.string().optional(),
+  critical_pull_time: z.string().optional(),
+  customer_branch: z.string().optional(),
+  customer_reference: CustomerReference$zodSchema.optional(),
+  dangerous_goods: DangerousGoodsObject$zodSchema.optional(),
+  dangerous_goods_code: DangerousGoodsCode$zodSchema.optional(),
+  dealer_order_number: UPSReferenceFields$zodSchema.optional(),
+  delivery_instructions: z.string().optional(),
+  dept_number: DepartmentNumber$zodSchema.optional(),
+  dry_ice: DryIce$zodSchema.optional(),
+  fda_product_code: UPSReferenceFields$zodSchema.optional(),
+  fulfillment_center: z.string().optional(),
+  insurance: Insurance$zodSchema.optional(),
+  invoice_number: InvoiceNumber$zodSchema.optional(),
+  is_return: z.boolean().optional(),
+  lasership_attrs: z.array(ShipmentExtraLasershipAttributesEnum$zodSchema)
+    .optional(),
+  lasership_declared_value: z.string().optional(),
+  manifest_number: UPSReferenceFields$zodSchema.optional(),
+  model_number: UPSReferenceFields$zodSchema.optional(),
+  part_number: UPSReferenceFields$zodSchema.optional(),
+  po_number: PoNumber$zodSchema.optional(),
+  preferred_delivery_timeframe: PreferredDeliveryTimeframe$zodSchema.optional(),
+  premium: z.boolean().optional(),
+  production_code: UPSReferenceFields$zodSchema.optional(),
+  purchase_request_number: UPSReferenceFields$zodSchema.optional(),
+  qr_code_requested: z.boolean().optional(),
+  reference_1: z.string().optional(),
+  reference_2: z.string().optional(),
+  request_retail_rates: z.boolean().optional(),
+  return_service_type: z.union([
+    ShipmentExtraReturnServiceTypeUPSEnum$zodSchema,
+    ShipmentExtraReturnServiceTypeLasershipEnum$zodSchema,
+  ]).optional(),
+  rma_number: RmaNumber$zodSchema.optional(),
+  salesperson_number: UPSReferenceFields$zodSchema.optional(),
+  saturday_delivery: z.boolean().optional(),
+  serial_number: UPSReferenceFields$zodSchema.optional(),
+  signature_confirmation: SignatureConfirmation$zodSchema.optional(),
+  store_number: UPSReferenceFields$zodSchema.optional(),
+  transaction_reference_number: UPSReferenceFields$zodSchema.optional(),
+}).describe("An object holding optional extra services to be requested.");