find_apisBrowse and filter every API in the catalog.
get_api_artifactsOne API's artifacts, grouped by type.
get_openapiThe primary OpenAPI for this API.
find_similar_apisAPIs that look like this one.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools →

Call it yourself

curl for this page

This API

curl "https://apis.io/api/v1/apis/vtex-shipping-updates-api"

All apis

curl "https://apis.io/api/v1/apis?limit=25"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

OpenAPI Specification

openapi: 3.2.0
info:
  title: VTex Pick and Pack Last Mile Protocol Shipping Updates API
  description: "The Pick and Pack Last Mile Protocol API enables seamless integration between the [Pick and Pack](https://help.vtex.com/en/tutorial/vtex-pick-and-pack--1OOops3WrUyz7e0bnhkfXU) app and delivery services. This API allows carriers and brokers to securely and efficiently exchange shipment information with the Pick and Pack app. It streamlines the process of managing orders, updating shipping statuses, and handling various service-related tasks, ensuring timely and accurate delivery updates. \n\n>ℹ️ Blank fields are included as `null` instead of being omitted.\n## Authentication\n- [`POST` Create an access token](https://developers.vtex.com/docs/api-reference/pick-and-pack-protocol-api#post-/token)\n\n## Service integration\n-  [`POST` Create a service](https://developers.vtex.com/docs/api-reference/pick-and-pack-protocol-api#post-/create-service)\n\n## Carriers\n-  [`POST` Calculate rates](https://developers.vtex.com/docs/api-reference/pick-and-pack-protocol-api#post-/rates)\n-  [`POST` List carriers](https://developers.vtex.com/docs/api-reference/pick-and-pack-protocol-api#post-/list-carriers)\n\n## Shipping updates\n-  [`GET` Get a service](https://developers.vtex.com/docs/api-reference/pick-and-pack-protocol-api#get-/-carrierId-/-serviceId-)\n-  [`PATCH` Update service](https://developers.vtex.com/docs/api-reference/pick-and-pack-protocol-api#patch-/-carrierId-/-serviceId-)\n-  [`POST` Create notes](https://developers.vtex.com/docs/api-reference/pick-and-pack-protocol-api#post-/notes/-carrierId-/-serviceId-)\n-  [`POST` Create evidence](https://developers.vtex.com/docs/api-reference/pick-and-pack-protocol-api#post-/evidences/-carrierId-/-serviceId-)\n-  [`POST` Create labels](https://developers.vtex.com/docs/api-reference/pick-and-pack-protocol-api#post-/labels/-carrierId-/-serviceId-)\n-  [`POST` Cancel service](https://developers.vtex.com/docs/api-reference/pick-and-pack-protocol-api#post-/cancel-service)\n-  [`POST` Cancel ongoing service](https://developers.vtex.com/docs/api-reference/pick-and-pack-protocol-api#post-/cancel/service/-carrierId-/-serviceId-)\n-  [`POST` Pause and resume service](https://developers.vtex.com/docs/api-reference/pick-and-pack-protocol-api#post-/pause-service)\n-  [`POST` Create on hold service](https://developers.vtex.com/docs/api-reference/pick-and-pack-protocol-api#post-/on-hold/-carrierId-/-serviceId-)"
  version: '1.0'
servers:
- url: https://auth.pickingnpacking.com/{environment}
  variables:
    environment:
      default: DefaultParameterValue
      description: Server to access the authentication necessary to make a request in the Pick and Pack Provider API.
- url: https://{store_endpoint}
  variables:
    your_endpoint:
      default: storeapi.com
      description: Server from the store.
- url: https://api.pickingnpacking.com/{environment}/v1/tracking/hook
  variables:
    environment:
      default: DefaultParameterValue
      description: Environment of the Pick and Pack Protocol App.
tags:
- name: Shipping Updates
  description: This endpoint will allow the carriers to update an ongoing shipping service.
paths:
  /{carrierId}/{serviceId}:
    get:
      tags:
      - Shipping Updates
      summary: VTex Get service
      description: 'Returns information about a service, which can be queried by providing the carrier ID and the corresponding service ID as query parameters.


        ## Permissions


        This endpoint does not require [permissions](https://help.vtex.com/en/tutorial/license-manager-resources--3q6ztrC8YynQf6rdc6euk3).'
      operationId: Getservice
      parameters:
      - name: carrierId
        in: path
        description: Carrier ID.
        required: true
        style: simple
        schema:
          type: string
          example: MTEyMjMtQWZ0ZXJTaGlwLWRldmVsb3BtZW50
      - name: serviceId
        in: path
        description: Service ID generated by the carrier.
        required: true
        style: simple
        schema:
          type: string
          example: 78c83922-d658-48bf-89d5-0658a6a94e27
      - $ref: '#/components/parameters/Content-Type'
      - $ref: '#/components/parameters/Accept'
      - $ref: '#/components/parameters/Authorization'
      responses:
        '200':
          description: OK
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/ServiceBody'
              example:
                message: success
                data:
                  id: 519400fb-f980-4a6a-809c-9f986fdb98a4
                  orderId: 46369545534253-01
                  carrierId: MTEyMjMtQWZ0ZXJTaGlwLWRldmVsb3BtZW50
                  serviceId: MTEyMjMtQWZ0ZXJTaGlwLWRldmVsb3BtZW50&78c83922-d658-48bf-89d5-0658a6a94e27
                  carrierName: AfterShip
                  seller: lastmile
                  status: DELIVERED
                  type: PICKUP_DELIVERY
                  tags: []
                  labels:
                  - id: 78c83922-d658-48bf-89d5-0658a6a94e27
                    name: Shipping label
                    url: https://sandbox-download.postmen.com/label/2024-03-09/258a26a4-45ae-49eb-b64d-929d3b81f46d-1709947994279763.pdf
                    type: PDF
                  evidences: []
                  packages:
                  - id: a46e5bc1-8959-459f-a094-b6e699f7214c
                    orderId: 46369545534253-01
                    envelope: Foam or Plastic Containers
                    dimensions:
                      height: '5'
                      length: '11'
                      width: '7'
                    weight: '48'
                    totalValue: 5352
                    items:
                    - id: '184'
                      name: Chicken
                      ean: EAN354
                      quantity: 8
                      price: 669
                      refId: '314'
                      image: https://picsum.photos/seed/YtoZ9/128/480
                      type: other
                      weight: '6'
                    categories:
                    - Movies
                    - Garden
                    - Books
                    description: Unde deserunt libero cupiditate illum.
                  timeline:
                  - id: 77263f59-0ac5-4b0c-bfe5-f17a1648474d
                    date: '2024-03-09T01:33:14.917Z'
                    createdAt: '2024-03-09T01:33:14.917Z'
                    updatedAt: '2024-03-09T01:33:14.917Z'
                    type: STATUS
                    description: Service pending in DEV
                    author: System
                    metaData:
                      shippingEstimatedDate: '2024-01-05T11:11:11.000Z'
                      metaData:
                        shippingEstimatedDate: '2024-01-05T11:11:11.000Z'
                        metaData: null
                        serviceId: 78c83922-d658-48bf-89d5-0658a6a94e27
                        shippingPrice: 284.02
                        status: PENDING
                        labels:
                        - name: Shipping label
                          id: 78c83922-d658-48bf-89d5-0658a6a94e27
                          type: PDF
                          url: https://sandbox-download.postmen.com/label/2024-03-09/258a26a4-45ae-49eb-b64d-929d3b81f46d-1709947994279763.pdf
                      serviceId: 78c83922-d658-48bf-89d5-0658a6a94e27
                      shippingPrice: 284.02
                      status: PENDING
                      labels:
                      - name: Shipping label
                        id: 78c83922-d658-48bf-89d5-0658a6a94e27
                        type: PDF
                        url: https://sandbox-download.postmen.com/label/2024-03-09/258a26a4-45ae-49eb-b64d-929d3b81f46d-1709947994279763.pdf
                  - id: 9906da15-15e4-4dbd-8e90-c34ec43ed446
                    date: '2024-03-09T01:46:20.006Z'
                    createdAt: '2024-03-09T01:46:20.006Z'
                    updatedAt: '2024-03-09T01:46:20.006Z'
                    type: NOTE
                    description: A new note has been added
                    author: afterShip
                    metaData:
                      '0':
                        type: COMMENT
                        note: The package is delivered at the door
                        author: afterShip
                  - id: 35619274-3bca-4749-8a38-53a62776144a
                    date: '2024-03-09T01:44:17.437Z'
                    createdAt: '2024-03-09T01:44:17.437Z'
                    updatedAt: '2024-03-09T01:44:17.437Z'
                    type: NOTE
                    description: A new note has been added
                    author: afterShip
                    metaData:
                      '0':
                        type: COMMENT
                        note: 'Tracking Number: 10001709948594168'
                        author: afterShip
                  - id: 9b60e3fd-5bf9-43c6-99f2-4292a57fa408
                    date: '2024-03-09T01:46:19.689Z'
                    createdAt: '2024-03-09T01:46:19.689Z'
                    updatedAt: '2024-03-09T01:46:19.689Z'
                    type: STATUS
                    description: The package was delivered
                    author: System
                    metaData:
                      shippingEstimatedDate: '2024-01-05T11:11:11.000Z'
                      trackingUrl: https://tools.usps.com/go/TrackConfirmAction?tLabels=9361289676091361892011
                      status: DELIVERED
                  - id: 21c9acaa-e14b-41bd-aaa7-a2cebd7384c0
                    date: '2024-03-09T01:43:15.887Z'
                    createdAt: '2024-03-09T01:43:15.887Z'
                    updatedAt: '2024-03-09T01:43:15.887Z'
                    type: STATUS
                    description: Service pending
                    author: System
                    metaData:
                      shippingEstimatedDate: '2024-01-05T11:11:11.000Z'
                      trackingUrl: https://tools.usps.com/go/TrackConfirmAction?tLabels=9361289676091361892011
                      status: PENDING
                  - id: 7a1a3a63-f94c-49f1-a912-bc3f095d7845
                    date: '2024-03-09T01:45:18.812Z'
                    createdAt: '2024-03-09T01:45:18.812Z'
                    updatedAt: '2024-03-09T01:45:18.812Z'
                    type: STATUS
                    description: Courier picked the package
                    author: System
                    metaData:
                      shippingEstimatedDate: '2024-01-05T11:11:11.000Z'
                      trackingUrl: https://tools.usps.com/go/TrackConfirmAction?tLabels=9361289676091361892011
                      status: PICKED
                  - id: 9ca25940-bdae-4f19-a5b4-92477abfa059
                    date: '2024-03-09T01:33:14.978Z'
                    createdAt: '2024-03-09T01:33:14.978Z'
                    updatedAt: '2024-03-09T01:33:14.978Z'
                    type: LABEL
                    description: Added a label
                    author: System
                    metaData:
                      name: Shipping label
                      id: 78c83922-d658-48bf-89d5-0658a6a94e27
                      type: PDF
                      url: https://sandbox-download.postmen.com/label/2024-03-09/258a26a4-45ae-49eb-b64d-929d3b81f46d-1709947994279763.pdf
                  - id: 24b84b8b-7418-4ed8-bc89-b6a1cbee2331
                    date: '2024-03-09T01:43:16.289Z'
                    createdAt: '2024-03-09T01:43:16.289Z'
                    updatedAt: '2024-03-09T01:43:16.289Z'
                    type: NOTE
                    description: A new note has been added
                    author: afterShip
                    metaData:
                      '0':
                        type: COMMENT
                        note: 'Tracking Number: 10001709948594168'
                        author: afterShip
                  - id: 9dfad688-e99a-4b27-9ccb-959da40c3bf8
                    date: '2024-03-09T01:33:08.385Z'
                    createdAt: '2024-03-09T01:33:08.385Z'
                    updatedAt: '2024-03-09T01:33:08.385Z'
                    type: STATUS
                    description: Service creation by AfterShip
                    author: System
                    metaData:
                      status: CREATED
                  - id: 781ab0af-e62a-4a21-a837-8d0eea3f57c2
                    date: '2024-03-09T01:44:17.077Z'
                    createdAt: '2024-03-09T01:44:17.077Z'
                    updatedAt: '2024-03-09T01:44:17.077Z'
                    type: STATUS
                    description: Courier on route
                    author: System
                    metaData:
                      shippingEstimatedDate: '2024-01-05T11:11:11.000Z'
                      trackingUrl: https://tools.usps.com/go/TrackConfirmAction?tLabels=9361289676091361892011
                      status: ON_ROUTE
                  notes:
                  - type: COMMENT
                    date: '2024-03-09T01:43:16.280Z'
                    content: 'Tracking Number: 10001709948594168'
                    author: afterShip
                  - type: COMMENT
                    date: '2024-03-09T01:44:17.423Z'
                    content: 'Tracking Number: 10001709948594168'
                    author: afterShip
                  - type: COMMENT
                    date: '2024-03-09T01:46:19.998Z'
                    content: The package is delivered at the door
                    author: afterShip
                  timezone:
                    offset: 300
                    value: America/Bogota
                    label: null
                  carrierLogo: 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
                  trackingUrl: https://tools.usps.com/go/TrackConfirmAction?tLabels=9361289676091361892011
                  comments: Comments.
                  paymentMethod: ONLINE
                  carrierServiceType: BROKER
                  rate:
                    shippingPrice:
                      value: 0
                      currency: USD
                    insurancePrice:
                      value: 0
                      currency: USD
                  shippingEstimatedDate: '2024-01-05T11:11:11.000Z'
                  shippingFinishedDate: '2024-01-05T11:11:11.000Z'
                  metaData:
                    integrationResponse: {}
                    carrier:
                      name: '[FedEx] Postmen Testing Account'
                      image: null
                      metaData: {}
                      id: fedex
                      type:
                        metaData: {}
                        terms: ''
                        rate:
                          shippingPrice:
                            value: 284.02
                            currency: USD
                          insurancePrice:
                            value: 0
                            currency: USD
                        name: FedEx First Overnight®
                        transitTime: 0
                        shippingEstimatedDate: '2024-01-05T11:11:11.000Z'
                        description: FedEx
                        id: fedex_first_overnight
                        international: false
        '401':
          description: Unauthorized
          content:
            application/json; charset=utf-8:
              schema:
                $ref: '#/components/schemas/m4031'
              example:
                message: Unauthorized
                requestId: c7c1ce02-b63f-4001-a1ac-798554c85bd6
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/m4031'
              example:
                message: Invalid token
                requestId: 09563f82-fe06-4004-b623-85e3aa4c92c9
        '404':
          description: Not Found
          content:
            application/json; charset=utf-8:
              schema:
                $ref: '#/components/schemas/m4041'
              example:
                type: exception
                code: TRP0005E
                data:
                  '0': '1'
                  carrierId: MTEyMjMtQWZ0ZXJTaGlwLWRldmVsb3BtZW50
                  serviceId: 78c83922-d658-48bf-89d5-0658a6a94e27
                requestId: 9e3ce442-458c-4861-99aa-23b2cd2da9cf
                date: '2024-03-15T06:00:21.009Z'
                message: 'Service not found: ''MTEyMjMtQWZ0ZXJTaGlwLWRldmVsb3BtZW50&78c83922-d658-48bf-89d5-0658a6a94e27'''
      deprecated: false
      servers:
      - url: https://api.pickingnpacking.com/{environment}/v1/tracking/hook
        variables:
          environment:
            default: DefaultParameterValue
    patch:
      tags:
      - Shipping Updates
      summary: VTex Update service
      description: 'Updates a service with the details of the tracking service via webhook.


        ## Permissions


        This endpoint does not require [permissions](https://help.vtex.com/en/tutorial/license-manager-resources--3q6ztrC8YynQf6rdc6euk3).'
      operationId: Updateservice
      parameters:
      - name: carrierId
        in: path
        description: Carrier ID.
        required: true
        style: simple
        schema:
          type: string
          example: MTEyMjMtQWZ0ZXJTaGlwLWRldmVsb3BtZW50
      - name: serviceId
        in: path
        description: Service ID.
        required: true
        style: simple
        schema:
          type: string
          example: 78c83922-d658-48bf-89d5-0658a6a94e27
      - $ref: '#/components/parameters/Content-Type'
      - $ref: '#/components/parameters/Accept'
      - $ref: '#/components/parameters/Authorization'
      requestBody:
        content:
          application/json:
            schema:
              $ref: '#/components/schemas/UpdateserviceRequest'
            example:
              message: Service updated successfully
              data:
                status: PENDING
                agent:
                  id: '27327489234'
                  name: Pedro
                  identification: 020323809
                  phone: '+57314855674'
                  email: pedro434234@gmailc.om
                  vehicle: SCOOTER
                trackingUrl: https://localhost.com
                totalDistanceTraveled: 2
                rating: 5
                shippingPrice: 150000
                shippingEstimatedDate: '2024-04-27T20:25:45.067Z'
        required: true
      responses:
        '200':
          description: OK
          content:
            application/json; charset=utf-8:
              schema:
                $ref: '#/components/schemas/ServiceBody1'
              example:
                message: Service updated successfully
                data:
                  status: PENDING
                  agent:
                    id: '27327489234'
                    name: Pedro
                    identification: 020323809
                    phone: '+57314855674'
                    email: pedro434234@gmailc.om
                    vehicle: SCOOTER
                  trackingUrl: https://localhost.com
                  totalDistanceTraveled: 2
                  rating: 5
                  shippingPrice: 150000
                  shippingEstimatedDate: '2024-04-27T20:25:45.067Z'
        '401':
          description: Unauthorized
          content:
            application/json; charset=utf-8:
              schema:
                $ref: '#/components/schemas/m4031'
              example:
                message: Unauthorized
                requestId: b5077045-e5ee-4eeb-8783-467c5454d03c
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/m4031'
              example:
                message: Authentication token expired
                requestId: 6d5f5fa2-cf31-4878-9be5-7e094022a206
        '404':
          description: Not Found
          content:
            application/json; charset=utf-8:
              schema:
                $ref: '#/components/schemas/m4041'
              example:
                type: exception
                code: TRP0005E
                data:
                  '0': '1'
                  carrierId: MTEyMjMtQWZ0ZXJTaGlwLWRldmVsb3BtZW50
                  serviceId: 78c83922-d658-48bf-89d5-0658a6a94e27
                requestId: 8ce83c17-d9c4-434f-94cd-f2016bb7be8a
                date: '2024-03-15T05:59:30.114Z'
                message: 'Service not found: ''MTEyMjMtQWZ0ZXJTaGlwLWRldmVsb3BtZW50&_78c83922-d658-48bf-89d5-0658a6a94e27'''
      deprecated: false
      servers:
      - url: https://api.pickingnpacking.com/{environment}/v1/tracking/hook
        variables:
          environment:
            default: DefaultParameterValue
  /notes/{carrierId}/{serviceId}:
    post:
      tags:
      - Shipping Updates
      summary: VTex Create notes
      description: 'Allows carriers to add notes and information on existing services.


        ## Permissions


        This endpoint does not require [permissions](https://help.vtex.com/en/tutorial/license-manager-resources--3q6ztrC8YynQf6rdc6euk3).'
      operationId: Createnotes
      parameters:
      - name: carrierId
        in: path
        description: Carrier ID.
        required: true
        style: simple
        schema:
          type: string
          example: MTEyMjMtQWZ0ZXJTaGlwLWRldmVsb3BtZW50
      - name: serviceId
        in: path
        description: Service ID.
        required: true
        style: simple
        schema:
          type: string
          example: 78c83922-d658-48bf-89d5-0658a6a94e27
      - $ref: '#/components/parameters/Content-Type'
      - $ref: '#/components/parameters/Accept'
      - $ref: '#/components/parameters/Authorization'
      requestBody:
        content:
          application/json:
            schema:
              type: array
              items:
                $ref: '#/components/schemas/CreatenotesRequest'
            example:
            - type: ERROR
              note: The package takes time to be shipped
              author: Oscar Rojas
            - type: COMMENT
              note: The package was picked up
              author: Oscar Rojas
        required: true
      responses:
        '200':
          description: OK
          content:
            application/json; charset=utf-8:
              schema:
                $ref: '#/components/schemas/ServiceBody3'
              example:
                message: Notes saved successfully
                data:
                - type: ERROR
                  note: The package takes time to be shipped
                  author: Oscar Rojas
                - type: COMMENT
                  note: The package was picked up
                  author: Oscar Rojas
        '401':
          description: Unauthorized
          content:
            application/json; charset=utf-8:
              schema:
                $ref: '#/components/schemas/m4031'
              example:
                message: Unauthorized
                requestId: 3c685f11-45ec-4b8a-88ce-b9fff421eafe
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/m4031'
              example:
                message: Authentication token expired
                requestId: 6fd59420-57c6-4111-bb32-e2aa35eff256
        '404':
          description: Not Found
          content:
            application/json; charset=utf-8:
              schema:
                $ref: '#/components/schemas/m4041'
              example:
                type: exception
                code: TRP0005E
                data:
                  '0': '1'
                  carrierId: MTEyMjMtQWZ0ZXJTaGlwLWRldmVsb3BtZW50
                  serviceId: servicemock
                requestId: 6129725b-fbb1-42dd-9ec2-4fefecce41c1
                date: '2024-03-15T06:14:15.950Z'
                message: 'Service not found: ''MTEyMjMtQWZ0ZXJTaGlwLWRldmVsb3BtZW50&servicemock'''
      deprecated: false
      servers:
      - url: https://api.pickingnpacking.com/{environment}/v1/tracking/hook
        variables:
          environment:
            default: DefaultParameterValue
  /evidences/{carrierId}/{serviceId}:
    post:
      tags:
      - Shipping Updates
      summary: VTex Create evidence
      description: 'Allows the carrier to add evidence of delivery or pickup to the shipping service, as photos, text.


        ## Permissions


        This endpoint does not require [permissions](https://help.vtex.com/en/tutorial/license-manager-resources--3q6ztrC8YynQf6rdc6euk3).'
      operationId: Createevidence
      parameters:
      - name: carrierId
        in: path
        description: Carrier ID.
        required: true
        style: simple
        schema:
          type: string
          example: MTEyMjMtQWZ0ZXJTaGlwLWRldmVsb3BtZW50
      - name: serviceId
        in: path
        description: Service ID.
        required: true
        style: simple
        schema:
          type: string
          example: 78c83922-d658-48bf-89d5-0658a6a94e27
      - $ref: '#/components/parameters/Content-Type'
      - $ref: '#/components/parameters/Accept'
      - $ref: '#/components/parameters/Authorization'
      requestBody:
        content:
          application/json:
            schema:
              type: array
              items:
                $ref: '#/components/schemas/CreateevidenceRequest'
              example:
              - type: IMAGE
                content: https://parkers-images.bauersecure.com/wp-images/18727/courier-van-insurance-01.jpg
                author: Felipe Cardenas
              - type: TEXT
                content: The package was delivered
                author: Felipe Cardenas
        required: true
      responses:
        '200':
          description: OK
          content:
            application/json; charset=utf-8:
              schema:
                $ref: '#/components/schemas/ServiceBody4'
              example:
                message: Evidences saved successfully
                data:
                - type: IMAGE
                  content: https://parkers-images.bauersecure.com/wp-images/18727/courier-van-insurance-01.jpg
                  author: Felipe Cardenas
                - type: TEXT
                  content: The package was delivered
                  author: Felipe Cardenas
        '401':
          description: Unauthorized
          content:
            application/json; charset=utf-8:
              schema:
                $ref: '#/components/schemas/m4031'
              example:
                message: Unauthorized
                requestId: c482e112-aa73-4dfb-a31c-1586978dfead
        '403':
          description: Forbidden
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/m4031'
              example:
                message: Authentication token expired
                requestId: bcd67893-292d-4547-a01f-62feb56f8a74
        '404':
          description: Not Found
          content:
            application/json; charset=utf-8:
              schema:
                $ref: '#/components/schemas/m4041'
              example:
                type: exception
                code: TRP0005E
                data:
                  '0': '1'
                  carrierId: MTEyMjMtQWZ0ZXJTaGlwLWRldmVsb3BtZW50
                  serviceId: 78c83922-d658-48bf-89d5-0658a6a94e27
                requestId: b39a0833-629f-429e-8955-f448165502ac
                date: '2024-03-15T06:22:50.518Z'
                message: 'Service not found: ''MTEyMjMtQWZ0ZXJTaGlwLWRldmVsb3BtZW50&_78c83922-d658-48bf-89d5-0658a6a94e27'''
      deprecated: false
      servers:
      - url: https://api.pickingnpacking.com/{environment}/v1/tracking/hook
        variables:
          environment:
            default: DefaultParameterValue
  /labels/{carrierId}/{serviceId}:
    post:
      tags:
      - Shipping Updates
      summary: VTex Create label
      description: "Allows the carrier to create and add a shipping label to an order. \n\nIt is important that the tag ID is a unique value, if this value is repeated it will throw an exception. \n\n> ⚠️ If the label is type `BASE64` or `TXT`, the max size that allowed is 180kb. \n\n## Permissions\n\nThis endpoint does not require [permissions](https://help.vtex.com/en/tutorial/license-manager-resources--3q6ztrC8YynQf6rdc6euk3)."
      operationId: Createlabels
      parameters:
      - name: ca

# --- truncated at 32 KB (93 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/vtex/refs/heads/main/openapi/vtex-shipping-updates-api-openapi.yml