@itentialopensource/adapter-pitney_bowes 0.1.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (94) hide show
  1. package/.eslintignore +6 -0
  2. package/.eslintrc.js +18 -0
  3. package/.gitlab/.gitkeep +0 -0
  4. package/.gitlab/issue_templates/.gitkeep +0 -0
  5. package/.gitlab/issue_templates/Default.md +17 -0
  6. package/.gitlab/issue_templates/bugReportTemplate.md +76 -0
  7. package/.gitlab/issue_templates/featureRequestTemplate.md +14 -0
  8. package/.jshintrc +0 -0
  9. package/AUTH.md +39 -0
  10. package/BROKER.md +199 -0
  11. package/CALLS.md +170 -0
  12. package/CHANGELOG.md +9 -0
  13. package/CODE_OF_CONDUCT.md +43 -0
  14. package/CONTRIBUTING.md +172 -0
  15. package/ENHANCE.md +69 -0
  16. package/LICENSE +201 -0
  17. package/PROPERTIES.md +641 -0
  18. package/README.md +337 -0
  19. package/SUMMARY.md +9 -0
  20. package/SYSTEMINFO.md +11 -0
  21. package/TROUBLESHOOT.md +47 -0
  22. package/adapter.js +3684 -0
  23. package/adapterBase.js +1787 -0
  24. package/entities/.generic/action.json +214 -0
  25. package/entities/.generic/schema.json +28 -0
  26. package/entities/.system/action.json +50 -0
  27. package/entities/.system/mockdatafiles/getToken-default.json +3 -0
  28. package/entities/.system/mockdatafiles/healthcheck-default.json +3 -0
  29. package/entities/.system/schema.json +19 -0
  30. package/entities/.system/schemaTokenReq.json +64 -0
  31. package/entities/.system/schemaTokenResp.json +53 -0
  32. package/entities/AddressValidation/action.json +44 -0
  33. package/entities/AddressValidation/schema.json +20 -0
  34. package/entities/Authentication/action.json +24 -0
  35. package/entities/Authentication/schema.json +30 -0
  36. package/entities/CarrierInfo/action.json +87 -0
  37. package/entities/CarrierInfo/mockdatafiles/getCarrierLicenseAgreement-default.json +3 -0
  38. package/entities/CarrierInfo/schema.json +22 -0
  39. package/entities/Container/action.json +24 -0
  40. package/entities/Container/schema.json +19 -0
  41. package/entities/CrossBorderQuotes/action.json +44 -0
  42. package/entities/CrossBorderQuotes/mockdatafiles/getCrossBorderQuotes-default.json +51 -0
  43. package/entities/CrossBorderQuotes/schema.json +20 -0
  44. package/entities/Manifests/action.json +66 -0
  45. package/entities/Manifests/schema.json +21 -0
  46. package/entities/ParcelProtection/action.json +85 -0
  47. package/entities/ParcelProtection/mockdatafiles/cancelParcelProtection-default.json +3 -0
  48. package/entities/ParcelProtection/mockdatafiles/getParcelProtectionCoverage-default.json +11 -0
  49. package/entities/ParcelProtection/mockdatafiles/getParcelProtectionQuote-default.json +8 -0
  50. package/entities/ParcelProtection/schema.json +22 -0
  51. package/entities/Pickup/action.json +44 -0
  52. package/entities/Pickup/schema.json +20 -0
  53. package/entities/RateParcels/action.json +24 -0
  54. package/entities/RateParcels/schema.json +19 -0
  55. package/entities/Shipment/action.json +86 -0
  56. package/entities/Shipment/schema.json +22 -0
  57. package/entities/Tracking/action.json +45 -0
  58. package/entities/Tracking/mockdatafiles/addTrackingEvents-default.json +3 -0
  59. package/entities/Tracking/schema.json +20 -0
  60. package/entities/TransactionReports/action.json +25 -0
  61. package/entities/TransactionReports/schema.json +19 -0
  62. package/error.json +190 -0
  63. package/package.json +85 -0
  64. package/pronghorn.json +2918 -0
  65. package/propertiesDecorators.json +14 -0
  66. package/propertiesSchema.json +1248 -0
  67. package/refs?service=git-upload-pack +0 -0
  68. package/report/PitneyBowes - ShippingAPI_OAS-OpenApi3Json.json +7675 -0
  69. package/report/creationReport.json +480 -0
  70. package/sampleProperties.json +197 -0
  71. package/test/integration/adapterTestBasicGet.js +83 -0
  72. package/test/integration/adapterTestConnectivity.js +93 -0
  73. package/test/integration/adapterTestIntegration.js +1402 -0
  74. package/test/unit/adapterBaseTestUnit.js +949 -0
  75. package/test/unit/adapterTestUnit.js +2417 -0
  76. package/utils/adapterInfo.js +206 -0
  77. package/utils/addAuth.js +94 -0
  78. package/utils/artifactize.js +146 -0
  79. package/utils/basicGet.js +50 -0
  80. package/utils/checkMigrate.js +63 -0
  81. package/utils/entitiesToDB.js +178 -0
  82. package/utils/findPath.js +74 -0
  83. package/utils/methodDocumentor.js +225 -0
  84. package/utils/modify.js +154 -0
  85. package/utils/packModificationScript.js +35 -0
  86. package/utils/patches2bundledDeps.js +90 -0
  87. package/utils/pre-commit.sh +32 -0
  88. package/utils/removeHooks.js +20 -0
  89. package/utils/setup.js +33 -0
  90. package/utils/tbScript.js +246 -0
  91. package/utils/tbUtils.js +490 -0
  92. package/utils/testRunner.js +298 -0
  93. package/utils/troubleshootingAdapter.js +195 -0
  94. package/workflows/README.md +3 -0
package/pronghorn.json ADDED
@@ -0,0 +1,2918 @@
1
+ {
2
+ "id": "@itentialopensource/adapter-pitney_bowes",
3
+ "type": "Adapter",
4
+ "export": "PitneyBowes",
5
+ "title": "Pitney_bowes",
6
+ "src": "adapter.js",
7
+ "roles": [
8
+ "admin"
9
+ ],
10
+ "methods": [
11
+ {
12
+ "name": "iapUpdateAdapterConfiguration",
13
+ "summary": "Updates the adapter configuration",
14
+ "description": "Updates the adapter configuration file with the provided changes",
15
+ "input": [
16
+ {
17
+ "name": "configFile",
18
+ "type": "string",
19
+ "info": "The name of the file to change",
20
+ "required": true,
21
+ "schema": {
22
+ "title": "configFile",
23
+ "type": "string"
24
+ }
25
+ },
26
+ {
27
+ "name": "changes",
28
+ "type": "object",
29
+ "info": "JSON object containing the configuration changes",
30
+ "required": true,
31
+ "schema": {
32
+ "title": "changes",
33
+ "type": "object"
34
+ }
35
+ },
36
+ {
37
+ "name": "entity",
38
+ "type": "string",
39
+ "info": "The entity in which the changes are being made",
40
+ "required": false,
41
+ "schema": {
42
+ "title": "entity",
43
+ "type": "string"
44
+ }
45
+ },
46
+ {
47
+ "name": "type",
48
+ "type": "string",
49
+ "info": "The type of file to change - action, schema, or mock",
50
+ "required": false,
51
+ "schema": {
52
+ "title": "type",
53
+ "type": "string"
54
+ }
55
+ },
56
+ {
57
+ "name": "action",
58
+ "type": "string",
59
+ "info": "The action to be changed",
60
+ "required": false,
61
+ "schema": {
62
+ "title": "action",
63
+ "type": "string"
64
+ }
65
+ }
66
+ ],
67
+ "output": {
68
+ "name": "result",
69
+ "type": "object",
70
+ "description": "A JSON Object containing status, code and the result",
71
+ "schema": {
72
+ "title": "result",
73
+ "type": "object"
74
+ }
75
+ },
76
+ "roles": [
77
+ "admin"
78
+ ],
79
+ "route": {
80
+ "verb": "POST",
81
+ "path": "/iapUpdateAdapterConfiguration"
82
+ },
83
+ "task": true
84
+ },
85
+ {
86
+ "name": "iapFindAdapterPath",
87
+ "summary": "Provides the ability to see if a particular API path is supported by the adapter",
88
+ "description": "Provides the ability to see if a particular API path is supported by the adapter",
89
+ "input": [
90
+ {
91
+ "name": "apiPath",
92
+ "type": "string",
93
+ "info": "The API Path you want to check - make sure to not include base path and version",
94
+ "description": "The API Path you want to check - make sure to not include base path and version",
95
+ "schema": {
96
+ "title": "apiPath",
97
+ "type": "string"
98
+ },
99
+ "required": true
100
+ }
101
+ ],
102
+ "output": {
103
+ "name": "result",
104
+ "type": "object",
105
+ "description": "A JSON Object containing the result",
106
+ "schema": {
107
+ "title": "result",
108
+ "type": "object"
109
+ }
110
+ },
111
+ "roles": [
112
+ "admin"
113
+ ],
114
+ "route": {
115
+ "verb": "POST",
116
+ "path": "/iapFindAdapterPath"
117
+ },
118
+ "task": true
119
+ },
120
+ {
121
+ "name": "iapSuspendAdapter",
122
+ "summary": "Suspends the adapter",
123
+ "description": "Suspends the adapter",
124
+ "input": [
125
+ {
126
+ "name": "mode",
127
+ "type": "enum",
128
+ "enumerals": [
129
+ "pause",
130
+ "error"
131
+ ],
132
+ "info": "How incoming requests are handled. Defaults to 'pause'",
133
+ "description": "How incoming requests are handled. Defaults to 'pause'",
134
+ "schema": {
135
+ "title": "mode",
136
+ "type": "string"
137
+ },
138
+ "required": false
139
+ }
140
+ ],
141
+ "output": {
142
+ "name": "result",
143
+ "type": "object",
144
+ "description": "A JSON Object containing the adapter suspended status",
145
+ "schema": {
146
+ "title": "result",
147
+ "type": "object"
148
+ }
149
+ },
150
+ "roles": [
151
+ "admin"
152
+ ],
153
+ "route": {
154
+ "verb": "POST",
155
+ "path": "/iapSuspendAdapter"
156
+ },
157
+ "task": true
158
+ },
159
+ {
160
+ "name": "iapUnsuspendAdapter",
161
+ "summary": "Unsuspends the adapter",
162
+ "description": "Unsuspends the adapter",
163
+ "input": [],
164
+ "output": {
165
+ "name": "result",
166
+ "type": "object",
167
+ "description": "A JSON Object containing the adapter suspended status",
168
+ "schema": {
169
+ "title": "result",
170
+ "type": "object"
171
+ }
172
+ },
173
+ "roles": [
174
+ "admin"
175
+ ],
176
+ "route": {
177
+ "verb": "POST",
178
+ "path": "/iapUnsuspendAdapter"
179
+ },
180
+ "task": true
181
+ },
182
+ {
183
+ "name": "iapGetAdapterQueue",
184
+ "summary": "Return the requests that are waiting in the queue if throttling is enabled",
185
+ "description": "Return the requests that are waiting in the queue if throttling is enabled",
186
+ "input": [],
187
+ "output": {
188
+ "name": "result",
189
+ "type": "object",
190
+ "description": "A JSON Object containing the adapter queue",
191
+ "schema": {
192
+ "title": "result",
193
+ "type": "object"
194
+ }
195
+ },
196
+ "roles": [
197
+ "admin"
198
+ ],
199
+ "route": {
200
+ "verb": "POST",
201
+ "path": "/iapGetAdapterQueue"
202
+ },
203
+ "task": true
204
+ },
205
+ {
206
+ "name": "iapTroubleshootAdapter",
207
+ "summary": "Runs troubleshoot script for adapter",
208
+ "description": "Runs troubleshoot script for adapter",
209
+ "input": [
210
+ {
211
+ "name": "props",
212
+ "type": "object",
213
+ "info": "Object containing configuration, healthcheck and auth properties {'connProps':{'host': 'api.service.com', 'base_path': '/', 'protocol': 'http', 'port': 443, 'version': 'v1'},'healthCheckEndpoint': '/healthcheck', 'auth': {'auth_method': 'no authentication', 'username': 'username', 'password': 'password'}}",
214
+ "required": true,
215
+ "schema": {
216
+ "title": "props",
217
+ "type": "object"
218
+ }
219
+ },
220
+ {
221
+ "name": "persistFlag",
222
+ "type": "boolean",
223
+ "info": "Whether the input properties should be saved",
224
+ "required": true
225
+ }
226
+ ],
227
+ "output": {
228
+ "name": "result",
229
+ "type": "object",
230
+ "description": "A JSON Object containing the test results",
231
+ "schema": {
232
+ "title": "result",
233
+ "type": "object"
234
+ }
235
+ },
236
+ "roles": [
237
+ "admin"
238
+ ],
239
+ "route": {
240
+ "verb": "POST",
241
+ "path": "/iapTroubleshootAdapter"
242
+ },
243
+ "task": true
244
+ },
245
+ {
246
+ "name": "iapRunAdapterHealthcheck",
247
+ "summary": "Runs healthcheck script for adapter",
248
+ "description": "Runs healthcheck script for adapter",
249
+ "input": [],
250
+ "output": {
251
+ "name": "result",
252
+ "type": "boolean",
253
+ "description": "Whether healthcheck passed or failed"
254
+ },
255
+ "roles": [
256
+ "admin"
257
+ ],
258
+ "route": {
259
+ "verb": "POST",
260
+ "path": "/iapRunAdapterHealthcheck"
261
+ },
262
+ "task": true
263
+ },
264
+ {
265
+ "name": "iapRunAdapterConnectivity",
266
+ "summary": "Runs connectivity check script for adapter",
267
+ "description": "Runs connectivity check script for adapter",
268
+ "input": [],
269
+ "output": {
270
+ "name": "result",
271
+ "type": "object",
272
+ "description": "A JSON Object containing the test results",
273
+ "schema": {
274
+ "title": "result",
275
+ "type": "object"
276
+ }
277
+ },
278
+ "roles": [
279
+ "admin"
280
+ ],
281
+ "route": {
282
+ "verb": "POST",
283
+ "path": "/iapRunAdapterConnectivity"
284
+ },
285
+ "task": true
286
+ },
287
+ {
288
+ "name": "iapRunAdapterBasicGet",
289
+ "summary": "Runs basicGet script for adapter",
290
+ "description": "Runs basicGet script for adapter",
291
+ "input": [],
292
+ "output": {
293
+ "name": "result",
294
+ "type": "object",
295
+ "description": "A JSON Object containing the test results",
296
+ "schema": {
297
+ "title": "result",
298
+ "type": "object"
299
+ }
300
+ },
301
+ "roles": [
302
+ "admin"
303
+ ],
304
+ "route": {
305
+ "verb": "POST",
306
+ "path": "/iapRunAdapterBasicGet"
307
+ },
308
+ "task": true
309
+ },
310
+ {
311
+ "name": "iapMoveAdapterEntitiesToDB",
312
+ "summary": "Moves entities from an adapter into the IAP database",
313
+ "description": "Moves entities from an adapter into the IAP database",
314
+ "input": [],
315
+ "output": {
316
+ "name": "res",
317
+ "type": "object",
318
+ "description": "A JSON Object containing status, code and the response from the mongo transaction",
319
+ "schema": {
320
+ "title": "res",
321
+ "type": "object"
322
+ }
323
+ },
324
+ "roles": [
325
+ "admin"
326
+ ],
327
+ "route": {
328
+ "verb": "POST",
329
+ "path": "/iapMoveAdapterEntitiesToDB"
330
+ },
331
+ "task": true
332
+ },
333
+ {
334
+ "name": "genericAdapterRequest",
335
+ "summary": "Makes the requested generic call",
336
+ "description": "Makes the requested generic call",
337
+ "input": [
338
+ {
339
+ "name": "uriPath",
340
+ "type": "string",
341
+ "info": "the path of the api call - do not include the host, port, base path or version",
342
+ "description": "the path of the api call",
343
+ "schema": {
344
+ "title": "uriPath",
345
+ "type": "string"
346
+ },
347
+ "required": true
348
+ },
349
+ {
350
+ "name": "restMethod",
351
+ "type": "string",
352
+ "info": "the rest method (GET, POST, PUT, PATCH, DELETE)",
353
+ "description": "the rest method (GET, POST, PUT, PATCH, DELETE)",
354
+ "schema": {
355
+ "title": "restMethod",
356
+ "type": "string"
357
+ },
358
+ "required": true
359
+ },
360
+ {
361
+ "name": "queryData",
362
+ "type": "object",
363
+ "info": "the query parameters to be put on the url (optional)",
364
+ "description": "the query parameters to be put on the url (optional)",
365
+ "schema": {
366
+ "title": "queryData",
367
+ "type": "object"
368
+ },
369
+ "required": false
370
+ },
371
+ {
372
+ "name": "requestBody",
373
+ "type": "object",
374
+ "info": "the payload to be sent with the request (optional)",
375
+ "description": "the payload to be sent with the request (optional)",
376
+ "schema": {
377
+ "title": "requestBody",
378
+ "type": "object"
379
+ },
380
+ "required": false
381
+ },
382
+ {
383
+ "name": "addlHeaders",
384
+ "type": "object",
385
+ "info": "additional headers to be put on the call (optional)",
386
+ "description": "additional headers to be put on the call (optional)",
387
+ "schema": {
388
+ "title": "addlHeaders",
389
+ "type": "object"
390
+ },
391
+ "required": false
392
+ }
393
+ ],
394
+ "output": {
395
+ "name": "result",
396
+ "type": "object",
397
+ "description": "A JSON Object containing status, code and the result",
398
+ "schema": {
399
+ "title": "result",
400
+ "type": "object"
401
+ }
402
+ },
403
+ "roles": [
404
+ "admin"
405
+ ],
406
+ "route": {
407
+ "verb": "POST",
408
+ "path": "/genericAdapterRequest"
409
+ },
410
+ "task": true
411
+ },
412
+ {
413
+ "name": "genericAdapterRequestNoBasePath",
414
+ "summary": "Makes the requested generic call",
415
+ "description": "Makes the requested generic call",
416
+ "input": [
417
+ {
418
+ "name": "uriPath",
419
+ "type": "string",
420
+ "info": "the path of the api call - do not include the host, port, base path or version",
421
+ "description": "the path of the api call",
422
+ "schema": {
423
+ "title": "uriPath",
424
+ "type": "string"
425
+ },
426
+ "required": true
427
+ },
428
+ {
429
+ "name": "restMethod",
430
+ "type": "string",
431
+ "info": "the rest method (GET, POST, PUT, PATCH, DELETE)",
432
+ "description": "the rest method (GET, POST, PUT, PATCH, DELETE)",
433
+ "schema": {
434
+ "title": "restMethod",
435
+ "type": "string"
436
+ },
437
+ "required": true
438
+ },
439
+ {
440
+ "name": "queryData",
441
+ "type": "object",
442
+ "info": "the query parameters to be put on the url (optional)",
443
+ "description": "the query parameters to be put on the url (optional)",
444
+ "schema": {
445
+ "title": "queryData",
446
+ "type": "object"
447
+ },
448
+ "required": false
449
+ },
450
+ {
451
+ "name": "requestBody",
452
+ "type": "object",
453
+ "info": "the payload to be sent with the request (optional)",
454
+ "description": "the payload to be sent with the request (optional)",
455
+ "schema": {
456
+ "title": "requestBody",
457
+ "type": "object"
458
+ },
459
+ "required": false
460
+ },
461
+ {
462
+ "name": "addlHeaders",
463
+ "type": "object",
464
+ "info": "additional headers to be put on the call (optional)",
465
+ "description": "additional headers to be put on the call (optional)",
466
+ "schema": {
467
+ "title": "addlHeaders",
468
+ "type": "object"
469
+ },
470
+ "required": false
471
+ }
472
+ ],
473
+ "output": {
474
+ "name": "result",
475
+ "type": "object",
476
+ "description": "A JSON Object containing status, code and the result",
477
+ "schema": {
478
+ "title": "result",
479
+ "type": "object"
480
+ }
481
+ },
482
+ "roles": [
483
+ "admin"
484
+ ],
485
+ "route": {
486
+ "verb": "POST",
487
+ "path": "/genericAdapterRequestNoBasePath"
488
+ },
489
+ "task": true
490
+ },
491
+ {
492
+ "name": "getDevice",
493
+ "summary": "Get the Appliance",
494
+ "description": "Get the Appliance",
495
+ "input": [
496
+ {
497
+ "name": "deviceName",
498
+ "type": "string",
499
+ "info": "An Appliance Device Name",
500
+ "required": true,
501
+ "schema": {
502
+ "title": "deviceName",
503
+ "type": "string"
504
+ }
505
+ }
506
+ ],
507
+ "output": {
508
+ "name": "result",
509
+ "type": "object",
510
+ "description": "A JSON Object containing status, code and the result",
511
+ "schema": {
512
+ "title": "result",
513
+ "type": "object"
514
+ }
515
+ },
516
+ "roles": [
517
+ "admin"
518
+ ],
519
+ "route": {
520
+ "verb": "POST",
521
+ "path": "/getDevice"
522
+ },
523
+ "task": true
524
+ },
525
+ {
526
+ "name": "getDevicesFiltered",
527
+ "summary": "Get Appliances that match the filter",
528
+ "description": "Get Appliances that match the filter",
529
+ "input": [
530
+ {
531
+ "name": "options",
532
+ "type": "object",
533
+ "info": "options - e.g. { 'start': 1, 'limit': 20, 'filter': { 'name': 'abc123' } }",
534
+ "required": true,
535
+ "schema": {
536
+ "title": "options",
537
+ "type": "object"
538
+ }
539
+ }
540
+ ],
541
+ "output": {
542
+ "name": "result",
543
+ "type": "array",
544
+ "description": "A JSON Object containing status, code and the result",
545
+ "schema": {
546
+ "title": "result",
547
+ "type": "array"
548
+ }
549
+ },
550
+ "roles": [
551
+ "admin"
552
+ ],
553
+ "route": {
554
+ "verb": "POST",
555
+ "path": "/getDevicesFiltered"
556
+ },
557
+ "task": true
558
+ },
559
+ {
560
+ "name": "isAlive",
561
+ "summary": "Checks the status for the provided Appliance",
562
+ "description": "Checks the status for the provided Appliance",
563
+ "input": [
564
+ {
565
+ "name": "deviceName",
566
+ "type": "string",
567
+ "info": "An Appliance Device Name",
568
+ "required": true,
569
+ "schema": {
570
+ "title": "deviceName",
571
+ "type": "string"
572
+ }
573
+ }
574
+ ],
575
+ "output": {
576
+ "name": "result",
577
+ "type": "boolean",
578
+ "description": "A JSON Object containing status, code and the result",
579
+ "schema": {
580
+ "title": "result",
581
+ "type": "boolean"
582
+ }
583
+ },
584
+ "roles": [
585
+ "admin"
586
+ ],
587
+ "route": {
588
+ "verb": "POST",
589
+ "path": "/isAlive"
590
+ },
591
+ "task": true
592
+ },
593
+ {
594
+ "name": "getConfig",
595
+ "summary": "Gets a config for the provided Appliance",
596
+ "description": "Gets a config for the provided Appliance",
597
+ "input": [
598
+ {
599
+ "name": "deviceName",
600
+ "type": "string",
601
+ "info": "An Appliance Device Name",
602
+ "required": true,
603
+ "schema": {
604
+ "title": "deviceName",
605
+ "type": "string"
606
+ }
607
+ },
608
+ {
609
+ "name": "format",
610
+ "type": "string",
611
+ "info": "The format to be returned - this is ignored as we always return json",
612
+ "required": false,
613
+ "schema": {
614
+ "title": "format",
615
+ "type": "string"
616
+ }
617
+ }
618
+ ],
619
+ "output": {
620
+ "name": "result",
621
+ "type": "object",
622
+ "description": "A JSON Object containing status, code and the result",
623
+ "schema": {
624
+ "title": "result",
625
+ "type": "object"
626
+ }
627
+ },
628
+ "roles": [
629
+ "admin"
630
+ ],
631
+ "route": {
632
+ "verb": "POST",
633
+ "path": "/getConfig"
634
+ },
635
+ "task": true
636
+ },
637
+ {
638
+ "name": "iapGetDeviceCount",
639
+ "summary": "Gets a device count from the system",
640
+ "description": "Gets a device count from the system",
641
+ "input": [],
642
+ "output": {
643
+ "name": "result",
644
+ "type": "object",
645
+ "description": "A JSON Object containing status, code and the result",
646
+ "schema": {
647
+ "title": "result",
648
+ "type": "object"
649
+ }
650
+ },
651
+ "roles": [
652
+ "admin"
653
+ ],
654
+ "route": {
655
+ "verb": "POST",
656
+ "path": "/iapGetDeviceCount"
657
+ },
658
+ "task": true
659
+ },
660
+ {
661
+ "name": "oauthToken",
662
+ "summary": "oauthToken",
663
+ "description": "This API call generates the OAuth token based on the Base64-encoded value of the API key and secret associated with your PB Shipping APIs developer account. The token expires after 10 hours, after which you must create a new one.",
664
+ "input": [
665
+ {
666
+ "name": "grantType",
667
+ "type": "string",
668
+ "info": ": string",
669
+ "required": false,
670
+ "schema": {
671
+ "title": "grantType",
672
+ "type": "string"
673
+ }
674
+ }
675
+ ],
676
+ "output": {
677
+ "name": "result",
678
+ "type": "object",
679
+ "description": "A JSON Object containing status, code and the result",
680
+ "schema": {
681
+ "title": "result",
682
+ "type": "object"
683
+ }
684
+ },
685
+ "roles": [
686
+ "admin"
687
+ ],
688
+ "route": {
689
+ "verb": "POST",
690
+ "path": "/oauthToken"
691
+ },
692
+ "task": true
693
+ },
694
+ {
695
+ "name": "getCarrierServiceRules",
696
+ "summary": "getCarrierServiceRules",
697
+ "description": "This operation retrieves the rules governing the carrier's services, including the available parcel types and the limits on weights and dimensions. **This API currently returns rules only for USPS** . Find more information at [Get Carrier Rules](https://shipping.pitneybowes.com/api/get-carrier-rules.html)",
698
+ "input": [
699
+ {
700
+ "name": "carrier",
701
+ "type": "string",
702
+ "info": "The carrier name. **Currently this must be set to: USPS**: ",
703
+ "required": true,
704
+ "schema": {
705
+ "title": "carrier",
706
+ "type": "string"
707
+ }
708
+ },
709
+ {
710
+ "name": "originCountryCode",
711
+ "type": "string",
712
+ "info": "The [two-character ISO country code](https://www.iso.org/obp/ui/#search) for the country where the shipment originates.: ",
713
+ "required": true,
714
+ "schema": {
715
+ "title": "originCountryCode",
716
+ "type": "string"
717
+ }
718
+ },
719
+ {
720
+ "name": "destinationCountryCode",
721
+ "type": "string",
722
+ "info": "The [two-character ISO country code](https://www.iso.org/obp/ui/#search) for the country of the shipment's destination address.: ",
723
+ "required": true,
724
+ "schema": {
725
+ "title": "destinationCountryCode",
726
+ "type": "string"
727
+ }
728
+ },
729
+ {
730
+ "name": "rateTypeId",
731
+ "type": "string",
732
+ "info": "The type of rate requested, such as COMMERCIAL_BASE. If a rate type is not specified, all eligible rate types are returned.: string",
733
+ "required": false,
734
+ "schema": {
735
+ "title": "rateTypeId",
736
+ "type": "string"
737
+ }
738
+ },
739
+ {
740
+ "name": "futureShipmentDate",
741
+ "type": "string",
742
+ "info": "If the shipment is for a future date, and if a rate change is expected before the shipment date, use this field to ensure you get the correct rates and correct rate rules...(description truncated): string",
743
+ "required": false,
744
+ "schema": {
745
+ "title": "futureShipmentDate",
746
+ "type": "string"
747
+ }
748
+ },
749
+ {
750
+ "name": "returnShipment",
751
+ "type": "string",
752
+ "info": "If set to true, provides only services applicable for return shipment.: string",
753
+ "required": false,
754
+ "schema": {
755
+ "title": "returnShipment",
756
+ "type": "string"
757
+ }
758
+ },
759
+ {
760
+ "name": "compactResponse",
761
+ "type": "boolean",
762
+ "info": "If set to true, returns only summary, without special service details.: boolean",
763
+ "required": false,
764
+ "schema": {
765
+ "title": "compactResponse",
766
+ "type": "boolean"
767
+ }
768
+ }
769
+ ],
770
+ "output": {
771
+ "name": "result",
772
+ "type": "object",
773
+ "description": "A JSON Object containing status, code and the result",
774
+ "schema": {
775
+ "title": "result",
776
+ "type": "object"
777
+ }
778
+ },
779
+ "roles": [
780
+ "admin"
781
+ ],
782
+ "route": {
783
+ "verb": "POST",
784
+ "path": "/getCarrierServiceRules"
785
+ },
786
+ "task": true
787
+ },
788
+ {
789
+ "name": "getCarrierLicenseAgreement",
790
+ "summary": "getCarrierLicenseAgreement",
791
+ "description": "This operation retrieves a carrier's license agreement. The operation is used in the [Carrier Registration Tutorial](https://shipping.pitneybowes.com/carrier-registration.html).",
792
+ "input": [
793
+ {
794
+ "name": "carrier",
795
+ "type": "string",
796
+ "info": "The carrier name. Currently this must be set to: UPS: ",
797
+ "required": true,
798
+ "schema": {
799
+ "title": "carrier",
800
+ "type": "string"
801
+ }
802
+ },
803
+ {
804
+ "name": "originCountryCode",
805
+ "type": "string",
806
+ "info": "The two-character ISO country code for the country where the shipment originates.: ",
807
+ "required": true,
808
+ "schema": {
809
+ "title": "originCountryCode",
810
+ "type": "string"
811
+ }
812
+ }
813
+ ],
814
+ "output": {
815
+ "name": "result",
816
+ "type": "object",
817
+ "description": "A JSON Object containing status, code and the result",
818
+ "schema": {
819
+ "allOf": [
820
+ {
821
+ "title": "ShippingservicesV1CarrierLicenseAgreementsResponse",
822
+ "type": "object",
823
+ "properties": {
824
+ "licenseText": {
825
+ "type": "string"
826
+ }
827
+ }
828
+ },
829
+ {
830
+ "example": {
831
+ "licenseText": "<text>"
832
+ }
833
+ }
834
+ ]
835
+ }
836
+ },
837
+ "roles": [
838
+ "admin"
839
+ ],
840
+ "route": {
841
+ "verb": "POST",
842
+ "path": "/getCarrierLicenseAgreement"
843
+ },
844
+ "task": true
845
+ },
846
+ {
847
+ "name": "getCarrierSupportedDestination",
848
+ "summary": "getCarrierSupportedDestination",
849
+ "description": "This operation returns a list of supported destination countries to which the carrier offers international shipping services.",
850
+ "input": [
851
+ {
852
+ "name": "carrier",
853
+ "type": "string",
854
+ "info": "The carrier name. Currently this must be set to: USPS: ",
855
+ "required": true,
856
+ "schema": {
857
+ "title": "carrier",
858
+ "type": "string"
859
+ }
860
+ },
861
+ {
862
+ "name": "originCountryCode",
863
+ "type": "string",
864
+ "info": "The two-character ISO country code for the country where the shipment originates.: ",
865
+ "required": true,
866
+ "schema": {
867
+ "title": "originCountryCode",
868
+ "type": "string"
869
+ }
870
+ }
871
+ ],
872
+ "output": {
873
+ "name": "result",
874
+ "type": "object",
875
+ "description": "A JSON Object containing status, code and the result",
876
+ "schema": {
877
+ "title": "result",
878
+ "type": "object"
879
+ }
880
+ },
881
+ "roles": [
882
+ "admin"
883
+ ],
884
+ "route": {
885
+ "verb": "POST",
886
+ "path": "/getCarrierSupportedDestination"
887
+ },
888
+ "task": true
889
+ },
890
+ {
891
+ "name": "getCarrierFacilities",
892
+ "summary": "getCarrierFacilities",
893
+ "description": "This operation locates Post Offices and other facilities for a given carrier. You can use this operation, for example, to locate all USPS Post Offices near to a given postal code.If you use the Standard Return API and if you use the option to print a QR code, use this API to locate facilities where the buyer can print the label from the QR code.",
894
+ "input": [
895
+ {
896
+ "name": "body",
897
+ "type": "object",
898
+ "info": ": object",
899
+ "required": true,
900
+ "schema": {
901
+ "allOf": [
902
+ {
903
+ "type": "object"
904
+ },
905
+ {
906
+ "example": {
907
+ "address": {
908
+ "addressLines": [
909
+ "6525 Greenway Dr"
910
+ ],
911
+ "cityTown": "Roanoke",
912
+ "stateProvince": "VA",
913
+ "countryCode": "US"
914
+ },
915
+ "carrier": "USPS",
916
+ "carrierFacilityOptions": [
917
+ {
918
+ "name": "FACILITY_TYPE_SERVICE",
919
+ "value": "LABEL_BROKER_RETAIL"
920
+ },
921
+ {
922
+ "name": "FACILITY_TYPE",
923
+ "value": "POST_OFFICE"
924
+ },
925
+ {
926
+ "name": "FACILITY_WITHIN_RADIUS",
927
+ "value": "10"
928
+ },
929
+ {
930
+ "name": "NUMBER_OF_FACILITIES",
931
+ "value": "5"
932
+ }
933
+ ]
934
+ }
935
+ }
936
+ ],
937
+ "definitions": {}
938
+ }
939
+ }
940
+ ],
941
+ "output": {
942
+ "name": "result",
943
+ "type": "object",
944
+ "description": "A JSON Object containing status, code and the result",
945
+ "schema": {
946
+ "title": "result",
947
+ "type": "object"
948
+ }
949
+ },
950
+ "roles": [
951
+ "admin"
952
+ ],
953
+ "route": {
954
+ "verb": "POST",
955
+ "path": "/getCarrierFacilities"
956
+ },
957
+ "task": true
958
+ },
959
+ {
960
+ "name": "rateParcel",
961
+ "summary": "rateParcel",
962
+ "description": "Use this operation to rate a parcel before you print and purchase a shipment label. You can rate a parcel for multiple services and multiple parcel types with a single API request.",
963
+ "input": [
964
+ {
965
+ "name": "xPBShipperRatePlan",
966
+ "type": "string",
967
+ "info": "Shipper rate plan, if applicable",
968
+ "required": false,
969
+ "schema": {
970
+ "title": "xPBShipperRatePlan",
971
+ "type": "string"
972
+ }
973
+ },
974
+ {
975
+ "name": "xPBIntegratorCarrierId",
976
+ "type": "string",
977
+ "info": "Negotiated services rate, if applicable.",
978
+ "required": false,
979
+ "schema": {
980
+ "title": "xPBIntegratorCarrierId",
981
+ "type": "string"
982
+ }
983
+ },
984
+ {
985
+ "name": "xPBShipperCarrierAccountId",
986
+ "type": "string",
987
+ "info": "The unique identifier for the carrier account",
988
+ "required": false,
989
+ "schema": {
990
+ "title": "xPBShipperCarrierAccountId",
991
+ "type": "string"
992
+ }
993
+ },
994
+ {
995
+ "name": "includeDeliveryCommitment",
996
+ "type": "boolean",
997
+ "info": "When set to true, returns estimated transit time in days.: boolean",
998
+ "required": false,
999
+ "schema": {
1000
+ "title": "includeDeliveryCommitment",
1001
+ "type": "boolean"
1002
+ }
1003
+ },
1004
+ {
1005
+ "name": "carrier",
1006
+ "type": "string",
1007
+ "info": "Cross-Border only. Required for PB Cross-Border. Set this to PBI.: string",
1008
+ "required": false,
1009
+ "schema": {
1010
+ "title": "carrier",
1011
+ "type": "string"
1012
+ }
1013
+ },
1014
+ {
1015
+ "name": "body",
1016
+ "type": "object",
1017
+ "info": "Shipment request for Rates: object",
1018
+ "required": true,
1019
+ "schema": {
1020
+ "allOf": [
1021
+ {
1022
+ "type": "object"
1023
+ },
1024
+ {
1025
+ "description": "Shipment request for Rates",
1026
+ "example": {
1027
+ "fromAddress": {
1028
+ "company": "Supplier",
1029
+ "name": "J. Smith",
1030
+ "phone": "303-555-1213",
1031
+ "email": "js@example.com",
1032
+ "residential": false,
1033
+ "addressLines": [
1034
+ "4750 Walnut Street"
1035
+ ],
1036
+ "cityTown": "Boulder",
1037
+ "stateProvince": "CO",
1038
+ "postalCode": "80301",
1039
+ "countryCode": "US"
1040
+ },
1041
+ "toAddress": {
1042
+ "company": "Shop",
1043
+ "name": "J. Jones",
1044
+ "phone": "203-000-1234",
1045
+ "email": "jjones@example.com",
1046
+ "residential": false,
1047
+ "addressLines": [
1048
+ "771 Orange St"
1049
+ ],
1050
+ "cityTown": "New Haven",
1051
+ "stateProvince": "CT",
1052
+ "postalCode": "06511",
1053
+ "countryCode": "US"
1054
+ },
1055
+ "parcel": {
1056
+ "weight": {
1057
+ "weight": 1,
1058
+ "unitOfMeasurement": "OZ"
1059
+ },
1060
+ "dimension": {
1061
+ "length": 5,
1062
+ "width": 0.25,
1063
+ "height": 4,
1064
+ "unitOfMeasurement": "IN",
1065
+ "irregularParcelGirth": 1
1066
+ }
1067
+ },
1068
+ "rates": [
1069
+ {
1070
+ "carrier": "USPS",
1071
+ "parcelType": "PKG",
1072
+ "inductionPostalCode": "06484"
1073
+ }
1074
+ ]
1075
+ }
1076
+ }
1077
+ ],
1078
+ "definitions": {}
1079
+ }
1080
+ }
1081
+ ],
1082
+ "output": {
1083
+ "name": "result",
1084
+ "type": "object",
1085
+ "description": "A JSON Object containing status, code and the result",
1086
+ "schema": {
1087
+ "title": "result",
1088
+ "type": "object"
1089
+ }
1090
+ },
1091
+ "roles": [
1092
+ "admin"
1093
+ ],
1094
+ "route": {
1095
+ "verb": "POST",
1096
+ "path": "/rateParcel"
1097
+ },
1098
+ "task": true
1099
+ },
1100
+ {
1101
+ "name": "createShipmentLabel",
1102
+ "summary": "createShipmentLabel",
1103
+ "description": "The API returns the label as either a Base64 string or a link to a PDF. For more information visit [Create Shipment Documents](https://shipping.pitneybowes.com/api/post-shipments.html). Following are samples of different carriers -\n\n* [Create a USPS (U.S. Postal Service) Label](https://shipping.pitneybowes.com/api/post-shipments-usps.html)\n\n* [Create a USPS PMOD Label](https://shipping.pitneybowes.com/api/post-shipments-pmod.html)\n* [Create a USPS Scan-Based Return Label](https://shipping.pitney...(description truncated)",
1104
+ "input": [
1105
+ {
1106
+ "name": "xPBTransactionId",
1107
+ "type": "string",
1108
+ "info": "A unique identifier for the transaction, up to 25 characters",
1109
+ "required": true,
1110
+ "schema": {
1111
+ "title": "xPBTransactionId",
1112
+ "type": "string"
1113
+ }
1114
+ },
1115
+ {
1116
+ "name": "xPBIntegratorCarrierId",
1117
+ "type": "string",
1118
+ "info": "Negotiated services rate",
1119
+ "required": false,
1120
+ "schema": {
1121
+ "title": "xPBIntegratorCarrierId",
1122
+ "type": "string"
1123
+ }
1124
+ },
1125
+ {
1126
+ "name": "xPBShipperRatePlan",
1127
+ "type": "string",
1128
+ "info": "Shipper rate plan",
1129
+ "required": false,
1130
+ "schema": {
1131
+ "title": "xPBShipperRatePlan",
1132
+ "type": "string"
1133
+ }
1134
+ },
1135
+ {
1136
+ "name": "xPBShipmentGroupId",
1137
+ "type": "string",
1138
+ "info": "**[Required parameter for PBPresort service](https://shipping.pitneybowes.com/api/post-shipments-presort.html)**.The job number that represents the agreement between the merchant and PB Presort. This was provided by Pitney Bowes during [merchant onboarding for PB Presort](https://shipping.pitneybowes.com/carriers/pb-presort.html).",
1139
+ "required": false,
1140
+ "schema": {
1141
+ "title": "xPBShipmentGroupId",
1142
+ "type": "string"
1143
+ }
1144
+ },
1145
+ {
1146
+ "name": "xPBShipperCarrierAccountId",
1147
+ "type": "string",
1148
+ "info": "**[Required parameter for PBPresort service](https://shipping.pitneybowes.com/api/post-shipments-presort.html)**. The merchant's Mailer ID (MID), as provided by Pitney Bowes during merchant onboarding for PB Presort.",
1149
+ "required": false,
1150
+ "schema": {
1151
+ "title": "xPBShipperCarrierAccountId",
1152
+ "type": "string"
1153
+ }
1154
+ },
1155
+ {
1156
+ "name": "includeDeliveryCommitment",
1157
+ "type": "string",
1158
+ "info": "If set to true, returns estimated transit times in days. Only for USPS Create Shipment. See also [Pitney Bowes Delivery Guarantee](https://shipping.pitneybowes.com/faqs/d...(description truncated): string",
1159
+ "required": false,
1160
+ "schema": {
1161
+ "title": "includeDeliveryCommitment",
1162
+ "type": "string"
1163
+ }
1164
+ },
1165
+ {
1166
+ "name": "body",
1167
+ "type": "object",
1168
+ "info": "request: object",
1169
+ "required": true,
1170
+ "schema": {
1171
+ "allOf": [
1172
+ {
1173
+ "type": "object"
1174
+ },
1175
+ {
1176
+ "description": "request"
1177
+ }
1178
+ ],
1179
+ "definitions": {}
1180
+ }
1181
+ }
1182
+ ],
1183
+ "output": {
1184
+ "name": "result",
1185
+ "type": "object",
1186
+ "description": "A JSON Object containing status, code and the result",
1187
+ "schema": {
1188
+ "title": "result",
1189
+ "type": "object"
1190
+ }
1191
+ },
1192
+ "roles": [
1193
+ "admin"
1194
+ ],
1195
+ "route": {
1196
+ "verb": "POST",
1197
+ "path": "/createShipmentLabel"
1198
+ },
1199
+ "task": true
1200
+ },
1201
+ {
1202
+ "name": "retryShipment",
1203
+ "summary": "retryShipment",
1204
+ "description": "retryShipment",
1205
+ "input": [
1206
+ {
1207
+ "name": "originalTransactionId",
1208
+ "type": "string",
1209
+ "info": ": string",
1210
+ "required": true,
1211
+ "schema": {
1212
+ "title": "originalTransactionId",
1213
+ "type": "string"
1214
+ }
1215
+ }
1216
+ ],
1217
+ "output": {
1218
+ "name": "result",
1219
+ "type": "object",
1220
+ "description": "A JSON Object containing status, code and the result",
1221
+ "schema": {
1222
+ "title": "result",
1223
+ "type": "object"
1224
+ }
1225
+ },
1226
+ "roles": [
1227
+ "admin"
1228
+ ],
1229
+ "route": {
1230
+ "verb": "POST",
1231
+ "path": "/retryShipment"
1232
+ },
1233
+ "task": true
1234
+ },
1235
+ {
1236
+ "name": "reprintShipment",
1237
+ "summary": "reprintShipment",
1238
+ "description": "reprintShipment",
1239
+ "input": [
1240
+ {
1241
+ "name": "shipmentId",
1242
+ "type": "string",
1243
+ "info": "Required. The shipment ID that was issued when shipment label was generated.: string",
1244
+ "required": true,
1245
+ "schema": {
1246
+ "title": "shipmentId",
1247
+ "type": "string"
1248
+ }
1249
+ }
1250
+ ],
1251
+ "output": {
1252
+ "name": "result",
1253
+ "type": "object",
1254
+ "description": "A JSON Object containing status, code and the result",
1255
+ "schema": {
1256
+ "title": "result",
1257
+ "type": "object"
1258
+ }
1259
+ },
1260
+ "roles": [
1261
+ "admin"
1262
+ ],
1263
+ "route": {
1264
+ "verb": "POST",
1265
+ "path": "/reprintShipment"
1266
+ },
1267
+ "task": true
1268
+ },
1269
+ {
1270
+ "name": "cancelShipment",
1271
+ "summary": "cancelShipment",
1272
+ "description": "cancelShipment",
1273
+ "input": [
1274
+ {
1275
+ "name": "xPBTransactionId",
1276
+ "type": "string",
1277
+ "info": "A unique identifier for the transaction, up to 25 characters.",
1278
+ "required": true,
1279
+ "schema": {
1280
+ "title": "xPBTransactionId",
1281
+ "type": "string"
1282
+ }
1283
+ },
1284
+ {
1285
+ "name": "xPBShipperCarrierAccountId",
1286
+ "type": "string",
1287
+ "info": "The unique identifier returned in the shipperCarrierAccountId field by the [Register an Existing Carrier Account API.(https://shipping.pitneybowes.com/api/post-carrier-accounts-register.html)",
1288
+ "required": false,
1289
+ "schema": {
1290
+ "title": "xPBShipperCarrierAccountId",
1291
+ "type": "string"
1292
+ }
1293
+ },
1294
+ {
1295
+ "name": "cancelInitiator",
1296
+ "type": "string",
1297
+ "info": "Indicates that this refund request is initiated by the shipper. Set this to: SHIPPER: string",
1298
+ "required": false,
1299
+ "schema": {
1300
+ "title": "cancelInitiator",
1301
+ "type": "string"
1302
+ }
1303
+ },
1304
+ {
1305
+ "name": "carrier",
1306
+ "type": "string",
1307
+ "info": "Conditional. The carrier. This is required if the carrier is not USPS: ",
1308
+ "required": false,
1309
+ "schema": {
1310
+ "title": "carrier",
1311
+ "type": "string"
1312
+ }
1313
+ },
1314
+ {
1315
+ "name": "shipmentId",
1316
+ "type": "string",
1317
+ "info": "shipmentId: string",
1318
+ "required": true,
1319
+ "schema": {
1320
+ "title": "shipmentId",
1321
+ "type": "string"
1322
+ }
1323
+ }
1324
+ ],
1325
+ "output": {
1326
+ "name": "result",
1327
+ "type": "object",
1328
+ "description": "A JSON Object containing status, code and the result",
1329
+ "schema": {
1330
+ "title": "result",
1331
+ "type": "object"
1332
+ }
1333
+ },
1334
+ "roles": [
1335
+ "admin"
1336
+ ],
1337
+ "route": {
1338
+ "verb": "POST",
1339
+ "path": "/cancelShipment"
1340
+ },
1341
+ "task": true
1342
+ },
1343
+ {
1344
+ "name": "createManifest",
1345
+ "summary": "createManifest",
1346
+ "description": "This operation creates an end-of-day manifest that either combines all parcels into a single form or electronically closes the day, depending on the carrier. Use the instructions appropriate to the carrier.\n* Create a [USPS SCAN Form](https://shipping.pitneybowes.com/api/post-manifests-scan.html)\n\n* Create a [Newgistics Closeout](https://shipping.pitneybowes.com/api/post-manifests-newgistics.html)\n* Create a [PB Presort Pickup Slip](https://shipping.pitneybowes.com/api/post-manifests-presort.htm...(description truncated)",
1347
+ "input": [
1348
+ {
1349
+ "name": "xPBTransactionId",
1350
+ "type": "string",
1351
+ "info": "A unique identifier for the transaction, up to 25 characters.",
1352
+ "required": true,
1353
+ "schema": {
1354
+ "title": "xPBTransactionId",
1355
+ "type": "string"
1356
+ }
1357
+ },
1358
+ {
1359
+ "name": "body",
1360
+ "type": "object",
1361
+ "info": "manifest: object",
1362
+ "required": true,
1363
+ "schema": {
1364
+ "allOf": [
1365
+ {
1366
+ "type": "object"
1367
+ },
1368
+ {
1369
+ "description": "manifest"
1370
+ }
1371
+ ],
1372
+ "definitions": {}
1373
+ }
1374
+ }
1375
+ ],
1376
+ "output": {
1377
+ "name": "result",
1378
+ "type": "object",
1379
+ "description": "A JSON Object containing status, code and the result",
1380
+ "schema": {
1381
+ "title": "result",
1382
+ "type": "object"
1383
+ }
1384
+ },
1385
+ "roles": [
1386
+ "admin"
1387
+ ],
1388
+ "route": {
1389
+ "verb": "POST",
1390
+ "path": "/createManifest"
1391
+ },
1392
+ "task": true
1393
+ },
1394
+ {
1395
+ "name": "retryManifest",
1396
+ "summary": "retryManifest",
1397
+ "description": "retryManifest",
1398
+ "input": [
1399
+ {
1400
+ "name": "originalTransactionId",
1401
+ "type": "string",
1402
+ "info": ": string",
1403
+ "required": true,
1404
+ "schema": {
1405
+ "title": "originalTransactionId",
1406
+ "type": "string"
1407
+ }
1408
+ }
1409
+ ],
1410
+ "output": {
1411
+ "name": "result",
1412
+ "type": "object",
1413
+ "description": "A JSON Object containing status, code and the result",
1414
+ "schema": {
1415
+ "title": "result",
1416
+ "type": "object"
1417
+ }
1418
+ },
1419
+ "roles": [
1420
+ "admin"
1421
+ ],
1422
+ "route": {
1423
+ "verb": "POST",
1424
+ "path": "/retryManifest"
1425
+ },
1426
+ "task": true
1427
+ },
1428
+ {
1429
+ "name": "reprintManifest",
1430
+ "summary": "reprintManifest",
1431
+ "description": "reprintManifest",
1432
+ "input": [
1433
+ {
1434
+ "name": "manifestId",
1435
+ "type": "string",
1436
+ "info": "manifestId: string",
1437
+ "required": true,
1438
+ "schema": {
1439
+ "title": "manifestId",
1440
+ "type": "string"
1441
+ }
1442
+ }
1443
+ ],
1444
+ "output": {
1445
+ "name": "result",
1446
+ "type": "object",
1447
+ "description": "A JSON Object containing status, code and the result",
1448
+ "schema": {
1449
+ "title": "result",
1450
+ "type": "object"
1451
+ }
1452
+ },
1453
+ "roles": [
1454
+ "admin"
1455
+ ],
1456
+ "route": {
1457
+ "verb": "POST",
1458
+ "path": "/reprintManifest"
1459
+ },
1460
+ "task": true
1461
+ },
1462
+ {
1463
+ "name": "getTransactionReport",
1464
+ "summary": "getTransactionReport",
1465
+ "description": "This operation retrieves all transactions for a specified period of time.",
1466
+ "input": [
1467
+ {
1468
+ "name": "developerId",
1469
+ "type": "string",
1470
+ "info": "developerId: string",
1471
+ "required": true,
1472
+ "schema": {
1473
+ "title": "developerId",
1474
+ "type": "string"
1475
+ }
1476
+ },
1477
+ {
1478
+ "name": "fromDate",
1479
+ "type": "string",
1480
+ "info": "fromDate: string",
1481
+ "required": false,
1482
+ "schema": {
1483
+ "title": "fromDate",
1484
+ "type": "string"
1485
+ }
1486
+ },
1487
+ {
1488
+ "name": "shipDetails",
1489
+ "type": "number",
1490
+ "info": ": 123",
1491
+ "required": false,
1492
+ "schema": {
1493
+ "title": "shipDetails",
1494
+ "type": "number"
1495
+ }
1496
+ },
1497
+ {
1498
+ "name": "page",
1499
+ "type": "number",
1500
+ "info": ": 123",
1501
+ "required": false,
1502
+ "schema": {
1503
+ "title": "page",
1504
+ "type": "number"
1505
+ }
1506
+ },
1507
+ {
1508
+ "name": "size",
1509
+ "type": "number",
1510
+ "info": ": 123",
1511
+ "required": false,
1512
+ "schema": {
1513
+ "title": "size",
1514
+ "type": "number"
1515
+ }
1516
+ },
1517
+ {
1518
+ "name": "printStatus",
1519
+ "type": "string",
1520
+ "info": "printStatus: ",
1521
+ "required": false,
1522
+ "schema": {
1523
+ "title": "printStatus",
1524
+ "type": "string"
1525
+ }
1526
+ },
1527
+ {
1528
+ "name": "toDate",
1529
+ "type": "string",
1530
+ "info": "toDate: string",
1531
+ "required": false,
1532
+ "schema": {
1533
+ "title": "toDate",
1534
+ "type": "string"
1535
+ }
1536
+ },
1537
+ {
1538
+ "name": "transactionType",
1539
+ "type": "string",
1540
+ "info": "transactionType: ",
1541
+ "required": false,
1542
+ "schema": {
1543
+ "title": "transactionType",
1544
+ "type": "string"
1545
+ }
1546
+ },
1547
+ {
1548
+ "name": "merchantId",
1549
+ "type": "string",
1550
+ "info": "The value of the postalReportingNumber element in the [merchant object](https://shipping.pitneybowes.com/reference/resource-objects.html). This value is also the merchant...(description truncated): string",
1551
+ "required": false,
1552
+ "schema": {
1553
+ "title": "merchantId",
1554
+ "type": "string"
1555
+ }
1556
+ },
1557
+ {
1558
+ "name": "sort",
1559
+ "type": "string",
1560
+ "info": "Defines a property to sort on and the sort order. Sort order can be ascending (asc) or descending (desc). Use the following form-\n\n* **sort= , ** For example-\n**sort=tran...(description truncated): string",
1561
+ "required": false,
1562
+ "schema": {
1563
+ "title": "sort",
1564
+ "type": "string"
1565
+ }
1566
+ },
1567
+ {
1568
+ "name": "parcelTrackingNumber",
1569
+ "type": "string",
1570
+ "info": "Parcel tracking number of the shipment.: string",
1571
+ "required": false,
1572
+ "schema": {
1573
+ "title": "parcelTrackingNumber",
1574
+ "type": "string"
1575
+ }
1576
+ }
1577
+ ],
1578
+ "output": {
1579
+ "name": "result",
1580
+ "type": "object",
1581
+ "description": "A JSON Object containing status, code and the result",
1582
+ "schema": {
1583
+ "title": "result",
1584
+ "type": "object"
1585
+ }
1586
+ },
1587
+ "roles": [
1588
+ "admin"
1589
+ ],
1590
+ "route": {
1591
+ "verb": "POST",
1592
+ "path": "/getTransactionReport"
1593
+ },
1594
+ "task": true
1595
+ },
1596
+ {
1597
+ "name": "getPickupschedule",
1598
+ "summary": "getPickupschedule",
1599
+ "description": "This operation schedules a USPS package pickup from a residential or commercial location and provides a pickup confirmation number.",
1600
+ "input": [
1601
+ {
1602
+ "name": "xPBTransactionId",
1603
+ "type": "string",
1604
+ "info": "A unique identifier for the transaction, up to 25 characters.",
1605
+ "required": true,
1606
+ "schema": {
1607
+ "title": "xPBTransactionId",
1608
+ "type": "string"
1609
+ }
1610
+ },
1611
+ {
1612
+ "name": "body",
1613
+ "type": "object",
1614
+ "info": "Schedule Pickup request.: object",
1615
+ "required": true,
1616
+ "schema": {
1617
+ "allOf": [
1618
+ {
1619
+ "type": "object"
1620
+ },
1621
+ {
1622
+ "description": "Schedule Pickup request."
1623
+ }
1624
+ ],
1625
+ "definitions": {}
1626
+ }
1627
+ }
1628
+ ],
1629
+ "output": {
1630
+ "name": "result",
1631
+ "type": "object",
1632
+ "description": "A JSON Object containing status, code and the result",
1633
+ "schema": {
1634
+ "title": "result",
1635
+ "type": "object"
1636
+ }
1637
+ },
1638
+ "roles": [
1639
+ "admin"
1640
+ ],
1641
+ "route": {
1642
+ "verb": "POST",
1643
+ "path": "/getPickupschedule"
1644
+ },
1645
+ "task": true
1646
+ },
1647
+ {
1648
+ "name": "cancelPickup",
1649
+ "summary": "cancelPickup",
1650
+ "description": "This operation schedules a USPS package pickup from a residential or commercial location and provides a pickup confirmation number.",
1651
+ "input": [
1652
+ {
1653
+ "name": "xPBTransactionId",
1654
+ "type": "string",
1655
+ "info": "A unique identifier for the transaction, up to 25 characters.",
1656
+ "required": true,
1657
+ "schema": {
1658
+ "title": "xPBTransactionId",
1659
+ "type": "string"
1660
+ }
1661
+ },
1662
+ {
1663
+ "name": "pickupId",
1664
+ "type": "string",
1665
+ "info": "A unique identifier for the transaction, up to 25 characters: string",
1666
+ "required": true,
1667
+ "schema": {
1668
+ "title": "pickupId",
1669
+ "type": "string"
1670
+ }
1671
+ }
1672
+ ],
1673
+ "output": {
1674
+ "name": "result",
1675
+ "type": "object",
1676
+ "description": "A JSON Object containing status, code and the result",
1677
+ "schema": {
1678
+ "title": "result",
1679
+ "type": "object"
1680
+ }
1681
+ },
1682
+ "roles": [
1683
+ "admin"
1684
+ ],
1685
+ "route": {
1686
+ "verb": "POST",
1687
+ "path": "/cancelPickup"
1688
+ },
1689
+ "task": true
1690
+ },
1691
+ {
1692
+ "name": "verifyAddress",
1693
+ "summary": "verifyAddress",
1694
+ "description": "Address validation verifies and cleanses postal addresses within the United States to help ensure packages are rated accurately and shipments arrive at their final destinations on time.",
1695
+ "input": [
1696
+ {
1697
+ "name": "minimalAddressValidation",
1698
+ "type": "boolean",
1699
+ "info": "When set to true, the complete address (delivery line and last line) is validated but only the last line (city, state, and postal code) would be changed by the validation...(description truncated): boolean",
1700
+ "required": false,
1701
+ "schema": {
1702
+ "title": "minimalAddressValidation",
1703
+ "type": "boolean"
1704
+ }
1705
+ },
1706
+ {
1707
+ "name": "body",
1708
+ "type": "object",
1709
+ "info": "Address object that needs to be validated.: object",
1710
+ "required": true,
1711
+ "schema": {
1712
+ "allOf": [
1713
+ {
1714
+ "type": "object"
1715
+ },
1716
+ {
1717
+ "description": "Address object that needs to be validated."
1718
+ }
1719
+ ],
1720
+ "definitions": {}
1721
+ }
1722
+ }
1723
+ ],
1724
+ "output": {
1725
+ "name": "result",
1726
+ "type": "object",
1727
+ "description": "A JSON Object containing status, code and the result",
1728
+ "schema": {
1729
+ "title": "result",
1730
+ "type": "object"
1731
+ }
1732
+ },
1733
+ "roles": [
1734
+ "admin"
1735
+ ],
1736
+ "route": {
1737
+ "verb": "POST",
1738
+ "path": "/verifyAddress"
1739
+ },
1740
+ "task": true
1741
+ },
1742
+ {
1743
+ "name": "verifyAndSuggestAddress",
1744
+ "summary": "verifyAndSuggestAddress",
1745
+ "description": "This operation returns suggested addresses. Use this if the [Address Validation API](https://shipping.pitneybowes.com/api/post-address-verify.html) call has returned an error.",
1746
+ "input": [
1747
+ {
1748
+ "name": "returnSuggestions",
1749
+ "type": "string",
1750
+ "info": "To return suggested addresses, set this to true.: string",
1751
+ "required": true,
1752
+ "schema": {
1753
+ "title": "returnSuggestions",
1754
+ "type": "string"
1755
+ }
1756
+ },
1757
+ {
1758
+ "name": "body",
1759
+ "type": "object",
1760
+ "info": "Address object that needs to be validated.: object",
1761
+ "required": true,
1762
+ "schema": {
1763
+ "allOf": [
1764
+ {
1765
+ "type": "object"
1766
+ },
1767
+ {
1768
+ "description": "Address object that needs to be validated."
1769
+ }
1770
+ ],
1771
+ "definitions": {}
1772
+ }
1773
+ }
1774
+ ],
1775
+ "output": {
1776
+ "name": "result",
1777
+ "type": "object",
1778
+ "description": "A JSON Object containing status, code and the result",
1779
+ "schema": {
1780
+ "title": "result",
1781
+ "type": "object"
1782
+ }
1783
+ },
1784
+ "roles": [
1785
+ "admin"
1786
+ ],
1787
+ "route": {
1788
+ "verb": "POST",
1789
+ "path": "/verifyAndSuggestAddress"
1790
+ },
1791
+ "task": true
1792
+ },
1793
+ {
1794
+ "name": "getParcelProtectionQuote",
1795
+ "summary": "getParcelProtectionQuote",
1796
+ "description": "This API provides a quote for covering a shipment through Pitney Bowes [Parcel Protection](https://www.pitneybowes.com/us/ecommerce-delivery-services/parcel-protection.html).",
1797
+ "input": [
1798
+ {
1799
+ "name": "xPBTransactionId",
1800
+ "type": "string",
1801
+ "info": "A unique identifier for the transaction, up to 25 characters.",
1802
+ "required": true,
1803
+ "schema": {
1804
+ "title": "xPBTransactionId",
1805
+ "type": "string"
1806
+ }
1807
+ },
1808
+ {
1809
+ "name": "body",
1810
+ "type": "object",
1811
+ "info": "manifest: object",
1812
+ "required": true,
1813
+ "schema": {
1814
+ "allOf": [
1815
+ {
1816
+ "type": "object"
1817
+ },
1818
+ {
1819
+ "description": "manifest",
1820
+ "example": {
1821
+ "shipmentInfo": {
1822
+ "carrier": "USPS",
1823
+ "serviceId": "PM",
1824
+ "insuranceCoverageValue": 1000,
1825
+ "insuranceCoverageValueCurrency": "USD",
1826
+ "parcelInfo": {
1827
+ "commodityList": [
1828
+ {
1829
+ "categoryPath": "electronics",
1830
+ "itemCode": "SKU1084",
1831
+ "name": "Laptop",
1832
+ "url": "https://example.com/computers/laptop/1084"
1833
+ }
1834
+ ]
1835
+ },
1836
+ "shipperInfo": {
1837
+ "shipperID": "9024324564",
1838
+ "address": {
1839
+ "addressLines": [
1840
+ "545 Market St"
1841
+ ],
1842
+ "cityTown": "San Francisco",
1843
+ "stateProvince": "CA",
1844
+ "postalCode": "94105-2847",
1845
+ "countryCode": "US"
1846
+ }
1847
+ },
1848
+ "consigneeInfo": {
1849
+ "address": {
1850
+ "addressLines": [
1851
+ "284 W Fulton"
1852
+ ],
1853
+ "cityTown": "Garden City",
1854
+ "stateProvince": "KS",
1855
+ "postalCode": "67846",
1856
+ "countryCode": "US"
1857
+ }
1858
+ }
1859
+ }
1860
+ }
1861
+ }
1862
+ ],
1863
+ "definitions": {}
1864
+ }
1865
+ }
1866
+ ],
1867
+ "output": {
1868
+ "name": "result",
1869
+ "type": "object",
1870
+ "description": "A JSON Object containing status, code and the result",
1871
+ "schema": {
1872
+ "allOf": [
1873
+ {
1874
+ "title": "ParcelProtectionQuoteResponse",
1875
+ "required": [
1876
+ "parcelProtectionFees",
1877
+ "parcelProtectionFeesCurrencyCode",
1878
+ "parcelProtectionFeesBreakup"
1879
+ ],
1880
+ "type": "object",
1881
+ "properties": {
1882
+ "parcelProtectionFees": {
1883
+ "type": "number"
1884
+ },
1885
+ "parcelProtectionFeesCurrencyCode": {
1886
+ "type": "string"
1887
+ },
1888
+ "parcelProtectionFeesBreakup": {
1889
+ "title": "ParcelProtectionFeesBreakup",
1890
+ "required": [
1891
+ "basePremium",
1892
+ "technologyFee"
1893
+ ],
1894
+ "type": "object",
1895
+ "properties": {
1896
+ "basePremium": {
1897
+ "type": "number"
1898
+ },
1899
+ "technologyFee": {
1900
+ "type": "number"
1901
+ }
1902
+ }
1903
+ }
1904
+ }
1905
+ },
1906
+ {
1907
+ "example": {
1908
+ "parcelProtectionFees": 7.5,
1909
+ "parcelProtectionFeesCurrencyCode": "USD",
1910
+ "parcelProtectionFeesBreakup": {
1911
+ "basePremium": 7.25,
1912
+ "technologyFee": 0.25
1913
+ }
1914
+ }
1915
+ }
1916
+ ]
1917
+ }
1918
+ },
1919
+ "roles": [
1920
+ "admin"
1921
+ ],
1922
+ "route": {
1923
+ "verb": "POST",
1924
+ "path": "/getParcelProtectionQuote"
1925
+ },
1926
+ "task": true
1927
+ },
1928
+ {
1929
+ "name": "getParcelProtectionCoverage",
1930
+ "summary": "getParcelProtectionCoverage",
1931
+ "description": "This API lets merchants request Pitney Bowes [Parcel Protection](https://shipping.pitneybowes.com/faqs/parcel-protection.html) coverage for shipments. Merchants can request coverage for shipments created with the Shipping APIs as well as for shipments created with other platforms.",
1932
+ "input": [
1933
+ {
1934
+ "name": "xPBTransactionId",
1935
+ "type": "string",
1936
+ "info": "A unique identifier for the transaction, up to 25 characters.",
1937
+ "required": true,
1938
+ "schema": {
1939
+ "title": "xPBTransactionId",
1940
+ "type": "string"
1941
+ }
1942
+ },
1943
+ {
1944
+ "name": "body",
1945
+ "type": "object",
1946
+ "info": "manifest: object",
1947
+ "required": true,
1948
+ "schema": {
1949
+ "allOf": [
1950
+ {
1951
+ "type": "object"
1952
+ },
1953
+ {
1954
+ "description": "manifest",
1955
+ "example": {
1956
+ "shipmentInfo": {
1957
+ "trackingNumber": "940509898641491871138",
1958
+ "carrier": "USPS",
1959
+ "serviceId": "PM",
1960
+ "insuranceCoverageValue": 1000,
1961
+ "insuranceCoverageValueCurrency": "USD",
1962
+ "parcelInfo": {
1963
+ "commodityList": [
1964
+ {
1965
+ "categoryPath": "electronics",
1966
+ "itemCode": "SKU1084",
1967
+ "name": "Laptop",
1968
+ "url": "https://example.com/computers/laptop/1084"
1969
+ }
1970
+ ]
1971
+ },
1972
+ "shipperInfo": {
1973
+ "shipperID": "9024324564",
1974
+ "address": {
1975
+ "addressLines": [
1976
+ "545 Market St"
1977
+ ],
1978
+ "cityTown": "San Francisco",
1979
+ "stateProvince": "CA",
1980
+ "postalCode": "94105-2847",
1981
+ "countryCode": "US"
1982
+ },
1983
+ "companyName": "Supplies",
1984
+ "givenName": "John",
1985
+ "middleName": "James",
1986
+ "familyName": "Smith",
1987
+ "email": "john@example.com",
1988
+ "phoneNumbers": [
1989
+ {
1990
+ "number": "1234567890",
1991
+ "type": "business phone"
1992
+ }
1993
+ ]
1994
+ },
1995
+ "consigneeInfo": {
1996
+ "address": {
1997
+ "addressLines": [
1998
+ "284 W Fulton"
1999
+ ],
2000
+ "cityTown": "Garden City",
2001
+ "stateProvince": "KS",
2002
+ "postalCode": "67846",
2003
+ "countryCode": "US"
2004
+ },
2005
+ "companyName": "Shop",
2006
+ "givenName": "Mary",
2007
+ "middleName": "Anne",
2008
+ "familyName": "Jones",
2009
+ "email": "mary@example.com",
2010
+ "phoneNumbers": [
2011
+ {
2012
+ "number": "6205551234",
2013
+ "type": "business phone"
2014
+ },
2015
+ {
2016
+ "number": "6205554321",
2017
+ "type": "fax"
2018
+ }
2019
+ ]
2020
+ }
2021
+ }
2022
+ }
2023
+ }
2024
+ ],
2025
+ "definitions": {}
2026
+ }
2027
+ }
2028
+ ],
2029
+ "output": {
2030
+ "name": "result",
2031
+ "type": "object",
2032
+ "description": "A JSON Object containing status, code and the result",
2033
+ "schema": {
2034
+ "allOf": [
2035
+ {
2036
+ "title": "ParcelProtectionCreateResponse",
2037
+ "type": "object",
2038
+ "properties": {
2039
+ "transactionID": {
2040
+ "type": "string"
2041
+ },
2042
+ "parcelProtectionReferenceID": {
2043
+ "type": "string"
2044
+ },
2045
+ "parcelProtectionDate": {
2046
+ "type": "string"
2047
+ },
2048
+ "parcelProtectionFees": {
2049
+ "type": "number"
2050
+ },
2051
+ "parcelProtectionFeesCurrencyCode": {
2052
+ "type": "string"
2053
+ },
2054
+ "parcelProtectionFeesBreakup": {
2055
+ "title": "ParcelProtectionFeesBreakup1",
2056
+ "type": "object",
2057
+ "properties": {
2058
+ "basePremium": {
2059
+ "type": "number"
2060
+ },
2061
+ "technologyFee": {
2062
+ "type": "number"
2063
+ }
2064
+ }
2065
+ }
2066
+ }
2067
+ },
2068
+ {
2069
+ "example": {
2070
+ "transactionID": "44397664_ABCD1234_28d6fb80-6b92-4e69-b5bb-6656a00ce435",
2071
+ "parcelProtectionReferenceID": "IPPOL0000000012345678",
2072
+ "parcelProtectionDate": "2019-05-20 15:00:25.279+0000",
2073
+ "parcelProtectionFees": 7.5,
2074
+ "parcelProtectionFeesCurrencyCode": "USD",
2075
+ "parcelProtectionFeesBreakup": {
2076
+ "basePremium": 7.25,
2077
+ "technologyFee": 0.25
2078
+ }
2079
+ }
2080
+ }
2081
+ ]
2082
+ }
2083
+ },
2084
+ "roles": [
2085
+ "admin"
2086
+ ],
2087
+ "route": {
2088
+ "verb": "POST",
2089
+ "path": "/getParcelProtectionCoverage"
2090
+ },
2091
+ "task": true
2092
+ },
2093
+ {
2094
+ "name": "cancelParcelProtection",
2095
+ "summary": "cancelParcelProtection",
2096
+ "description": "This API lets merchants request Pitney Bowes [Parcel Protection](https://shipping.pitneybowes.com/faqs/parcel-protection.html) coverage for shipments. Merchants can request coverage for shipments created with the Shipping APIs as well as for shipments created with other platforms.",
2097
+ "input": [
2098
+ {
2099
+ "name": "xPBTransactionId",
2100
+ "type": "string",
2101
+ "info": "A unique identifier for the transaction, up to 25 characters.",
2102
+ "required": true,
2103
+ "schema": {
2104
+ "title": "xPBTransactionId",
2105
+ "type": "string"
2106
+ }
2107
+ },
2108
+ {
2109
+ "name": "parcelProtectionReferenceId",
2110
+ "type": "string",
2111
+ "info": "Required. The identifier for the PB Parcel Protection policy that is being voided.: string",
2112
+ "required": true,
2113
+ "schema": {
2114
+ "title": "parcelProtectionReferenceId",
2115
+ "type": "string"
2116
+ }
2117
+ },
2118
+ {
2119
+ "name": "body",
2120
+ "type": "object",
2121
+ "info": "manifest: object",
2122
+ "required": true,
2123
+ "schema": {
2124
+ "allOf": [
2125
+ {
2126
+ "type": "object"
2127
+ },
2128
+ {
2129
+ "description": "manifest",
2130
+ "example": {
2131
+ "shipperID": "9024324564",
2132
+ "parcelProtectionAccountID": "IPACT2345678"
2133
+ }
2134
+ }
2135
+ ],
2136
+ "definitions": {}
2137
+ }
2138
+ }
2139
+ ],
2140
+ "output": {
2141
+ "name": "result",
2142
+ "type": "object",
2143
+ "description": "A JSON Object containing status, code and the result",
2144
+ "schema": {
2145
+ "allOf": [
2146
+ {
2147
+ "title": "VoidParcelProtectionResponse",
2148
+ "type": "object",
2149
+ "properties": {
2150
+ "status": {
2151
+ "type": "string"
2152
+ }
2153
+ }
2154
+ },
2155
+ {
2156
+ "example": {
2157
+ "status": "Void_Success"
2158
+ }
2159
+ }
2160
+ ]
2161
+ }
2162
+ },
2163
+ "roles": [
2164
+ "admin"
2165
+ ],
2166
+ "route": {
2167
+ "verb": "POST",
2168
+ "path": "/cancelParcelProtection"
2169
+ },
2170
+ "task": true
2171
+ },
2172
+ {
2173
+ "name": "getParcelProtectionReports",
2174
+ "summary": "getParcelProtectionReports",
2175
+ "description": "This operation retrieves the policy status and other information on the Parcel Protection policies you have purchased for your shipments. Further Details https://shipping.pitneybowes.com/api/get-parcel-protection-reports.html",
2176
+ "input": [
2177
+ {
2178
+ "name": "xPBTransactionId",
2179
+ "type": "string",
2180
+ "info": "A unique identifier for the transaction, up to 25 characters.",
2181
+ "required": true,
2182
+ "schema": {
2183
+ "title": "xPBTransactionId",
2184
+ "type": "string"
2185
+ }
2186
+ },
2187
+ {
2188
+ "name": "developerId",
2189
+ "type": "string",
2190
+ "info": "Required. Your Pitney Bowes developer ID.: string",
2191
+ "required": true,
2192
+ "schema": {
2193
+ "title": "developerId",
2194
+ "type": "string"
2195
+ }
2196
+ },
2197
+ {
2198
+ "name": "policyCreatedFromDate",
2199
+ "type": "string",
2200
+ "info": "The beginning of the date range. Specify this value in UTC using the ISO 8601 standard. You must include both date and time, and you must end the time with Z to indicate ...(description truncated): string",
2201
+ "required": true,
2202
+ "schema": {
2203
+ "title": "policyCreatedFromDate",
2204
+ "type": "string"
2205
+ }
2206
+ },
2207
+ {
2208
+ "name": "policyCreatedToDate",
2209
+ "type": "string",
2210
+ "info": "The end of the date range. Specify this value in UTC using the ISO 8601 standard. You must include both date and time, and you must end the time with Z to indicate a zero...(description truncated): string",
2211
+ "required": false,
2212
+ "schema": {
2213
+ "title": "policyCreatedToDate",
2214
+ "type": "string"
2215
+ }
2216
+ },
2217
+ {
2218
+ "name": "policyReferenceId",
2219
+ "type": "string",
2220
+ "info": "The unique identifier for the PB Parcel Protection policy.].: string",
2221
+ "required": false,
2222
+ "schema": {
2223
+ "title": "policyReferenceId",
2224
+ "type": "string"
2225
+ }
2226
+ },
2227
+ {
2228
+ "name": "parcelTrackingNumber",
2229
+ "type": "string",
2230
+ "info": "The parcel tracking number of the shipment that the policy applies to.: string",
2231
+ "required": false,
2232
+ "schema": {
2233
+ "title": "parcelTrackingNumber",
2234
+ "type": "string"
2235
+ }
2236
+ },
2237
+ {
2238
+ "name": "merchantId",
2239
+ "type": "string",
2240
+ "info": "The merchant's Shipper ID. This is the value of the postalReportingNumber element in the Merchant Object.: string",
2241
+ "required": false,
2242
+ "schema": {
2243
+ "title": "merchantId",
2244
+ "type": "string"
2245
+ }
2246
+ },
2247
+ {
2248
+ "name": "policyStatus",
2249
+ "type": "string",
2250
+ "info": "Whether the policy is active or voided.: string",
2251
+ "required": false,
2252
+ "schema": {
2253
+ "title": "policyStatus",
2254
+ "type": "string"
2255
+ }
2256
+ },
2257
+ {
2258
+ "name": "size",
2259
+ "type": "string",
2260
+ "info": "The number of transactions to return per page in the result set.: string",
2261
+ "required": false,
2262
+ "schema": {
2263
+ "title": "size",
2264
+ "type": "string"
2265
+ }
2266
+ },
2267
+ {
2268
+ "name": "page",
2269
+ "type": "string",
2270
+ "info": "The index number of the page to return. Page index numbering starts at 0. Specifying page=0 returns the first page of the result set.: string",
2271
+ "required": false,
2272
+ "schema": {
2273
+ "title": "page",
2274
+ "type": "string"
2275
+ }
2276
+ },
2277
+ {
2278
+ "name": "sort",
2279
+ "type": "string",
2280
+ "info": "Defines a property to sort on and the sort order. Sort order can be ascending (asc) or descending (desc).: string",
2281
+ "required": false,
2282
+ "schema": {
2283
+ "title": "sort",
2284
+ "type": "string"
2285
+ }
2286
+ }
2287
+ ],
2288
+ "output": {
2289
+ "name": "result",
2290
+ "type": "object",
2291
+ "description": "A JSON Object containing status, code and the result",
2292
+ "schema": {
2293
+ "title": "result",
2294
+ "type": "object"
2295
+ }
2296
+ },
2297
+ "roles": [
2298
+ "admin"
2299
+ ],
2300
+ "route": {
2301
+ "verb": "POST",
2302
+ "path": "/getParcelProtectionReports"
2303
+ },
2304
+ "task": true
2305
+ },
2306
+ {
2307
+ "name": "getTrackingDetails",
2308
+ "summary": "getTrackingDetails",
2309
+ "description": "getTrackingDetails",
2310
+ "input": [
2311
+ {
2312
+ "name": "trackingNumber",
2313
+ "type": "string",
2314
+ "info": "The tracking number for the shipment.: string",
2315
+ "required": true,
2316
+ "schema": {
2317
+ "title": "trackingNumber",
2318
+ "type": "string"
2319
+ }
2320
+ },
2321
+ {
2322
+ "name": "packageIdentifierType",
2323
+ "type": "string",
2324
+ "info": "packageIdentifierType: string",
2325
+ "required": true,
2326
+ "schema": {
2327
+ "title": "packageIdentifierType",
2328
+ "type": "string"
2329
+ }
2330
+ },
2331
+ {
2332
+ "name": "carrier",
2333
+ "type": "string",
2334
+ "info": "carrier: ",
2335
+ "required": true,
2336
+ "schema": {
2337
+ "title": "carrier",
2338
+ "type": "string"
2339
+ }
2340
+ }
2341
+ ],
2342
+ "output": {
2343
+ "name": "result",
2344
+ "type": "object",
2345
+ "description": "A JSON Object containing status, code and the result",
2346
+ "schema": {
2347
+ "title": "result",
2348
+ "type": "object"
2349
+ }
2350
+ },
2351
+ "roles": [
2352
+ "admin"
2353
+ ],
2354
+ "route": {
2355
+ "verb": "POST",
2356
+ "path": "/getTrackingDetails"
2357
+ },
2358
+ "task": true
2359
+ },
2360
+ {
2361
+ "name": "addTrackingEvents",
2362
+ "summary": "addTrackingEvents",
2363
+ "description": "getTrackingDetails",
2364
+ "input": [
2365
+ {
2366
+ "name": "body",
2367
+ "type": "object",
2368
+ "info": "add track event: object",
2369
+ "required": true,
2370
+ "schema": {
2371
+ "allOf": [
2372
+ {
2373
+ "type": "object"
2374
+ },
2375
+ {
2376
+ "description": "add track event",
2377
+ "example": {
2378
+ "carrier": "NEWGISTICS",
2379
+ "references": [
2380
+ {
2381
+ "referenceType": "package",
2382
+ "referenceValue": "1Z00",
2383
+ "events": [
2384
+ {
2385
+ "eventCode": "DPB",
2386
+ "carrierEventCode": "DOAC",
2387
+ "eventDate": "2020-04-18",
2388
+ "eventTime": "12:48:10",
2389
+ "eventTimeOffset": "-06:00",
2390
+ "eventCity": "Decatur",
2391
+ "eventStateOrProvince": "IL",
2392
+ "postalCode": "62521",
2393
+ "country": "US"
2394
+ }
2395
+ ]
2396
+ },
2397
+ {
2398
+ "referenceType": "package",
2399
+ "referenceValue": "3Z30",
2400
+ "events": [
2401
+ {
2402
+ "eventCode": "DPB",
2403
+ "carrierEventCode": "DOAC",
2404
+ "eventDate": "2020-04-18",
2405
+ "eventTime": "12:50:00",
2406
+ "eventTimeOffset": "-06:00",
2407
+ "eventCity": "Decatur",
2408
+ "eventStateOrProvince": "IL",
2409
+ "postalCode": "62521",
2410
+ "country": "US"
2411
+ }
2412
+ ]
2413
+ }
2414
+ ]
2415
+ }
2416
+ }
2417
+ ],
2418
+ "definitions": {}
2419
+ }
2420
+ }
2421
+ ],
2422
+ "output": {
2423
+ "name": "result",
2424
+ "type": "object",
2425
+ "description": "A JSON Object containing status, code and the result",
2426
+ "schema": {
2427
+ "allOf": [
2428
+ {
2429
+ "title": "VoidParcelProtectionResponse",
2430
+ "type": "object",
2431
+ "properties": {
2432
+ "status": {
2433
+ "type": "string"
2434
+ }
2435
+ }
2436
+ },
2437
+ {
2438
+ "example": {
2439
+ "status": "success"
2440
+ }
2441
+ }
2442
+ ]
2443
+ }
2444
+ },
2445
+ "roles": [
2446
+ "admin"
2447
+ ],
2448
+ "route": {
2449
+ "verb": "POST",
2450
+ "path": "/addTrackingEvents"
2451
+ },
2452
+ "task": true
2453
+ },
2454
+ {
2455
+ "name": "getCrossBorderQuotes",
2456
+ "summary": "getCrossBorderQuotes",
2457
+ "description": "This operation provides an estimate of the duties, taxes, and transportation costs for the items in a buyer's online shopping basket. The API calculates how many separate parcels are required to ship the items and estimates costs. The API checks each item's eligibility to clear customs and returns the quote for eligible items. To look for futher info please look into [Cross-Border Quotes](https://shipping.pitneybowes.com/api/post-quotes.html#)",
2458
+ "input": [
2459
+ {
2460
+ "name": "body",
2461
+ "type": "object",
2462
+ "info": ": object",
2463
+ "required": true,
2464
+ "schema": {
2465
+ "allOf": [
2466
+ {
2467
+ "type": "object"
2468
+ },
2469
+ {
2470
+ "example": {
2471
+ "quoteCurrency": "USD",
2472
+ "basketCurrency": "USD",
2473
+ "fromAddress": {
2474
+ "name": "John Smith",
2475
+ "residential": false,
2476
+ "company": "Supplies",
2477
+ "addressLines": [
2478
+ "545 Market St"
2479
+ ],
2480
+ "cityTown": "San Francisco",
2481
+ "stateProvince": "CA",
2482
+ "postalCode": "94105",
2483
+ "countryCode": "US",
2484
+ "email": "john@example.com",
2485
+ "phone": "415-555-0000"
2486
+ },
2487
+ "toAddress": {
2488
+ "name": "Jan Jones",
2489
+ "residential": true,
2490
+ "addressLines": [
2491
+ "2168 King St N"
2492
+ ],
2493
+ "cityTown": "Waterloo",
2494
+ "stateProvince": "ON",
2495
+ "postalCode": "N2J 4G8",
2496
+ "countryCode": "CA",
2497
+ "email": "jan@example.com",
2498
+ "phone": "519-555-0000"
2499
+ },
2500
+ "basketItems": [
2501
+ {
2502
+ "brand": "",
2503
+ "categories": [
2504
+ {
2505
+ "categoryCode": "UNKNOWN",
2506
+ "descriptions": [
2507
+ {
2508
+ "locale": "en",
2509
+ "name": "Dress",
2510
+ "parentsNames": [
2511
+ "Clothing",
2512
+ "Women"
2513
+ ]
2514
+ }
2515
+ ],
2516
+ "parentCategoryCode": "6543",
2517
+ "url": "www.example.com"
2518
+ }
2519
+ ],
2520
+ "description": "Red Embroidered",
2521
+ "eccn": "EAR99",
2522
+ "hazmats": [
2523
+ "hazmat",
2524
+ "ormd"
2525
+ ],
2526
+ "hSTariffCode": "4203100001",
2527
+ "hSTariffCodeCountry": "AU",
2528
+ "identifiers": [
2529
+ {
2530
+ "number": "123456",
2531
+ "source": "isbn"
2532
+ }
2533
+ ],
2534
+ "imageUrls": [
2535
+ "www.example.com"
2536
+ ],
2537
+ "itemDimension": {
2538
+ "length": 11,
2539
+ "height": 8.5,
2540
+ "width": 5,
2541
+ "unitOfMeasurement": "IN"
2542
+ },
2543
+ "itemId": "G_123456",
2544
+ "manufacturer": "",
2545
+ "originCountryCode": "CN",
2546
+ "pricing": {
2547
+ "price": 20,
2548
+ "codPrice": [
2549
+ {
2550
+ "price": 20,
2551
+ "cod": "CA",
2552
+ "includesDuty": false,
2553
+ "includesTaxes": false
2554
+ }
2555
+ ],
2556
+ "dutiableValue": 20
2557
+ },
2558
+ "quantity": 2,
2559
+ "unitPrice": 19.99,
2560
+ "unitWeight": {
2561
+ "weight": 5,
2562
+ "unitOfMeasurement": "lb"
2563
+ },
2564
+ "url": "http://www.example.com/products/160921_030"
2565
+ }
2566
+ ],
2567
+ "rates": [
2568
+ {
2569
+ "carrier": "PBI",
2570
+ "serviceId": "PBXPS"
2571
+ }
2572
+ ],
2573
+ "shipmentOptions": [
2574
+ {
2575
+ "name": "SHIPPER_ID",
2576
+ "value": "9024324564"
2577
+ },
2578
+ {
2579
+ "name": "CLIENT_ID",
2580
+ "value": "789123"
2581
+ },
2582
+ {
2583
+ "name": "CARRIER_FACILITY_ID",
2584
+ "value": "US_ELOVATIONS_KY"
2585
+ }
2586
+ ]
2587
+ }
2588
+ }
2589
+ ],
2590
+ "definitions": {}
2591
+ }
2592
+ }
2593
+ ],
2594
+ "output": {
2595
+ "name": "result",
2596
+ "type": "object",
2597
+ "description": "A JSON Object containing status, code and the result",
2598
+ "schema": {
2599
+ "allOf": [
2600
+ {
2601
+ "title": "CrossBorderQuotesResponse",
2602
+ "type": "object",
2603
+ "properties": {
2604
+ "quote": {
2605
+ "type": "array",
2606
+ "items": {
2607
+ "title": "Quote",
2608
+ "type": "object",
2609
+ "properties": {
2610
+ "quoteCurrency": {
2611
+ "type": "string"
2612
+ },
2613
+ "quoteLines": {
2614
+ "type": "array",
2615
+ "items": {
2616
+ "title": "QuoteLine",
2617
+ "type": "object",
2618
+ "properties": {
2619
+ "lineId": {
2620
+ "type": "string"
2621
+ },
2622
+ "itemId": {
2623
+ "type": "string"
2624
+ },
2625
+ "quoteLineId": {
2626
+ "type": "string"
2627
+ },
2628
+ "quantity": {
2629
+ "type": "integer"
2630
+ },
2631
+ "unitRates": {
2632
+ "title": "UnitRates",
2633
+ "type": "object",
2634
+ "properties": {
2635
+ "unitPrice": {
2636
+ "type": "number"
2637
+ },
2638
+ "totalTaxAmount": {
2639
+ "type": "number"
2640
+ },
2641
+ "totalDutyAmount": {
2642
+ "type": "integer"
2643
+ },
2644
+ "serviceId": {
2645
+ "type": "string"
2646
+ },
2647
+ "baseCharge": {
2648
+ "type": "number"
2649
+ },
2650
+ "deliveryCommitment": {
2651
+ "title": "DeliveryCommitment1",
2652
+ "type": "object",
2653
+ "properties": {
2654
+ "minEstimatedNumberOfDays": {
2655
+ "type": "integer"
2656
+ },
2657
+ "maxEstimatedNumberOfDays": {
2658
+ "type": "integer"
2659
+ }
2660
+ }
2661
+ },
2662
+ "totalCarrierCharge": {
2663
+ "type": "number"
2664
+ }
2665
+ }
2666
+ },
2667
+ "lineRates": {
2668
+ "title": "LineRates",
2669
+ "type": "object",
2670
+ "properties": {
2671
+ "linePrice": {
2672
+ "type": "number"
2673
+ },
2674
+ "totalTaxAmount": {
2675
+ "type": "number"
2676
+ },
2677
+ "totalDutyAmount": {
2678
+ "type": "integer"
2679
+ },
2680
+ "serviceId": {
2681
+ "type": "string"
2682
+ },
2683
+ "baseCharge": {
2684
+ "type": "number"
2685
+ },
2686
+ "deliveryCommitment": {
2687
+ "title": "DeliveryCommitment1",
2688
+ "type": "object",
2689
+ "properties": {
2690
+ "minEstimatedNumberOfDays": {
2691
+ "type": "integer"
2692
+ },
2693
+ "maxEstimatedNumberOfDays": {
2694
+ "type": "integer"
2695
+ }
2696
+ }
2697
+ },
2698
+ "totalCarrierCharge": {
2699
+ "type": "number"
2700
+ }
2701
+ }
2702
+ }
2703
+ }
2704
+ },
2705
+ "description": ""
2706
+ },
2707
+ "totalPrice": {
2708
+ "type": "number"
2709
+ },
2710
+ "totalRates": {
2711
+ "title": "TotalRates",
2712
+ "type": "object",
2713
+ "properties": {
2714
+ "serviceId": {
2715
+ "type": "string"
2716
+ },
2717
+ "baseCharge": {
2718
+ "type": "number"
2719
+ },
2720
+ "deliveryCommitment": {
2721
+ "title": "DeliveryCommitment1",
2722
+ "type": "object",
2723
+ "properties": {
2724
+ "minEstimatedNumberOfDays": {
2725
+ "type": "integer"
2726
+ },
2727
+ "maxEstimatedNumberOfDays": {
2728
+ "type": "integer"
2729
+ }
2730
+ }
2731
+ },
2732
+ "totalCarrierCharge": {
2733
+ "type": "number"
2734
+ },
2735
+ "totalDutyAmount": {
2736
+ "type": "integer"
2737
+ },
2738
+ "totalTaxAmount": {
2739
+ "type": "number"
2740
+ }
2741
+ }
2742
+ }
2743
+ }
2744
+ },
2745
+ "description": ""
2746
+ }
2747
+ }
2748
+ },
2749
+ {
2750
+ "example": {
2751
+ "quote": [
2752
+ {
2753
+ "quoteCurrency": "USD",
2754
+ "quoteLines": [
2755
+ {
2756
+ "lineId": "1",
2757
+ "itemId": "G_123456",
2758
+ "quoteLineId": "1",
2759
+ "quantity": 2,
2760
+ "unitRates": {
2761
+ "unitPrice": 19.99,
2762
+ "totalTaxAmount": 3.12,
2763
+ "totalDutyAmount": 4,
2764
+ "serviceId": "PBXPS",
2765
+ "baseCharge": 23.62,
2766
+ "deliveryCommitment": {
2767
+ "minEstimatedNumberOfDays": 3,
2768
+ "maxEstimatedNumberOfDays": 6
2769
+ },
2770
+ "totalCarrierCharge": 30.74
2771
+ },
2772
+ "lineRates": {
2773
+ "linePrice": 39.98,
2774
+ "totalTaxAmount": 6.24,
2775
+ "totalDutyAmount": 8,
2776
+ "serviceId": "PBXPS",
2777
+ "baseCharge": 47.24,
2778
+ "deliveryCommitment": {
2779
+ "minEstimatedNumberOfDays": 3,
2780
+ "maxEstimatedNumberOfDays": 6
2781
+ },
2782
+ "totalCarrierCharge": 61.48
2783
+ }
2784
+ }
2785
+ ],
2786
+ "totalPrice": 39.98,
2787
+ "totalRates": {
2788
+ "serviceId": "PBXPS",
2789
+ "baseCharge": 47.24,
2790
+ "deliveryCommitment": {
2791
+ "minEstimatedNumberOfDays": 3,
2792
+ "maxEstimatedNumberOfDays": 6
2793
+ },
2794
+ "totalCarrierCharge": 61.48,
2795
+ "totalDutyAmount": 8,
2796
+ "totalTaxAmount": 6.24
2797
+ }
2798
+ }
2799
+ ]
2800
+ }
2801
+ }
2802
+ ]
2803
+ }
2804
+ },
2805
+ "roles": [
2806
+ "admin"
2807
+ ],
2808
+ "route": {
2809
+ "verb": "POST",
2810
+ "path": "/getCrossBorderQuotes"
2811
+ },
2812
+ "task": true
2813
+ },
2814
+ {
2815
+ "name": "predictedHSCode",
2816
+ "summary": "PredictedHSCode",
2817
+ "description": "This operation predicts the HS Code for a parcel being shipped internationally and gives the level of confidence in the prediction.",
2818
+ "input": [
2819
+ {
2820
+ "name": "xPBTransactionId",
2821
+ "type": "string",
2822
+ "info": "A unique identifier for the transaction, up to 25 characters.",
2823
+ "required": true,
2824
+ "schema": {
2825
+ "title": "xPBTransactionId",
2826
+ "type": "string"
2827
+ }
2828
+ },
2829
+ {
2830
+ "name": "body",
2831
+ "type": "object",
2832
+ "info": "manifest: object",
2833
+ "required": true,
2834
+ "schema": {
2835
+ "allOf": [
2836
+ {
2837
+ "type": "object"
2838
+ },
2839
+ {
2840
+ "description": "manifest"
2841
+ }
2842
+ ],
2843
+ "definitions": {}
2844
+ }
2845
+ }
2846
+ ],
2847
+ "output": {
2848
+ "name": "result",
2849
+ "type": "object",
2850
+ "description": "A JSON Object containing status, code and the result",
2851
+ "schema": {
2852
+ "title": "result",
2853
+ "type": "object"
2854
+ }
2855
+ },
2856
+ "roles": [
2857
+ "admin"
2858
+ ],
2859
+ "route": {
2860
+ "verb": "POST",
2861
+ "path": "/predictedHSCode"
2862
+ },
2863
+ "task": true
2864
+ },
2865
+ {
2866
+ "name": "getContainerizedParcelsLabels",
2867
+ "summary": "getContainerizedParcelsLabels",
2868
+ "description": "This operation prints a label for the shipment of containerized parcels destined for a Pitney Bowes warehouse facility from the client location.",
2869
+ "input": [
2870
+ {
2871
+ "name": "xPBTransactionId",
2872
+ "type": "string",
2873
+ "info": "A unique identifier for the transaction, up to 25 characters.",
2874
+ "required": true,
2875
+ "schema": {
2876
+ "title": "xPBTransactionId",
2877
+ "type": "string"
2878
+ }
2879
+ },
2880
+ {
2881
+ "name": "body",
2882
+ "type": "object",
2883
+ "info": "manifest: object",
2884
+ "required": true,
2885
+ "schema": {
2886
+ "allOf": [
2887
+ {
2888
+ "type": "object"
2889
+ },
2890
+ {
2891
+ "description": "manifest"
2892
+ }
2893
+ ],
2894
+ "definitions": {}
2895
+ }
2896
+ }
2897
+ ],
2898
+ "output": {
2899
+ "name": "result",
2900
+ "type": "object",
2901
+ "description": "A JSON Object containing status, code and the result",
2902
+ "schema": {
2903
+ "title": "result",
2904
+ "type": "object"
2905
+ }
2906
+ },
2907
+ "roles": [
2908
+ "admin"
2909
+ ],
2910
+ "route": {
2911
+ "verb": "POST",
2912
+ "path": "/getContainerizedParcelsLabels"
2913
+ },
2914
+ "task": true
2915
+ }
2916
+ ],
2917
+ "views": []
2918
+ }