@cloudcart/dev-mcp 0.2.3 → 0.2.4

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.
package/data/admin.json CHANGED
@@ -57,6 +57,33 @@
57
57
  "isDeprecated": false,
58
58
  "deprecationReason": null
59
59
  },
60
+ {
61
+ "name": "orderPayment",
62
+ "description": "Fetch a single order-payment record by its id. Includes the linked gateway-side payment via `gatewayPayment`. Admin agents use this before calling capturePayment / refundPayment / markPaymentPaid to confirm the current status of the payment.",
63
+ "args": [
64
+ {
65
+ "name": "id",
66
+ "description": "Order payment ID.",
67
+ "type": {
68
+ "kind": "NON_NULL",
69
+ "name": null,
70
+ "ofType": {
71
+ "kind": "SCALAR",
72
+ "name": "ID",
73
+ "ofType": null
74
+ }
75
+ },
76
+ "defaultValue": null
77
+ }
78
+ ],
79
+ "type": {
80
+ "kind": "OBJECT",
81
+ "name": "OrderPayment",
82
+ "ofType": null
83
+ },
84
+ "isDeprecated": false,
85
+ "deprecationReason": null
86
+ },
60
87
  {
61
88
  "name": "orderedProducts",
62
89
  "description": "Get aggregated ordered products across orders (for inventory/reporting).",
@@ -12010,6 +12037,94 @@
12010
12037
  "isDeprecated": false,
12011
12038
  "deprecationReason": null
12012
12039
  },
12040
+ {
12041
+ "name": "shippingCountries",
12042
+ "description": "List the countries a shipping provider services. Each provider's `listCountries()` is the source — for Speedy/DpdBulgaria/Sameday the list is populated, for providers that don't expose countries the list is empty. Combine with `shippingOffices(key, filter: {country: \"BG\"})` to narrow down to offices in a specific country.",
12043
+ "args": [
12044
+ {
12045
+ "name": "key",
12046
+ "description": "Provider app key (e.g. 'econt', 'speedy').",
12047
+ "type": {
12048
+ "kind": "NON_NULL",
12049
+ "name": null,
12050
+ "ofType": {
12051
+ "kind": "SCALAR",
12052
+ "name": "String",
12053
+ "ofType": null
12054
+ }
12055
+ },
12056
+ "defaultValue": null
12057
+ },
12058
+ {
12059
+ "name": "query",
12060
+ "description": "Optional name-fragment filter (uses each provider's `findCountries()` when supplied).",
12061
+ "type": {
12062
+ "kind": "SCALAR",
12063
+ "name": "String",
12064
+ "ofType": null
12065
+ },
12066
+ "defaultValue": null
12067
+ }
12068
+ ],
12069
+ "type": {
12070
+ "kind": "NON_NULL",
12071
+ "name": null,
12072
+ "ofType": {
12073
+ "kind": "LIST",
12074
+ "name": null,
12075
+ "ofType": {
12076
+ "kind": "NON_NULL",
12077
+ "name": null,
12078
+ "ofType": {
12079
+ "kind": "OBJECT",
12080
+ "name": "ShippingCountry",
12081
+ "ofType": null
12082
+ }
12083
+ }
12084
+ }
12085
+ },
12086
+ "isDeprecated": false,
12087
+ "deprecationReason": null
12088
+ },
12089
+ {
12090
+ "name": "shippingPdfFormats",
12091
+ "description": "List PDF output formats a shipping provider supports for waybill printing. Derived zero-config from the provider's pdf-select.tpl admin view, so newly added providers expose their formats without any GraphQL change. Agents pass the returned `type` to `getShippingWaybillPdf`.",
12092
+ "args": [
12093
+ {
12094
+ "name": "key",
12095
+ "description": "Provider app key.",
12096
+ "type": {
12097
+ "kind": "NON_NULL",
12098
+ "name": null,
12099
+ "ofType": {
12100
+ "kind": "SCALAR",
12101
+ "name": "String",
12102
+ "ofType": null
12103
+ }
12104
+ },
12105
+ "defaultValue": null
12106
+ }
12107
+ ],
12108
+ "type": {
12109
+ "kind": "NON_NULL",
12110
+ "name": null,
12111
+ "ofType": {
12112
+ "kind": "LIST",
12113
+ "name": null,
12114
+ "ofType": {
12115
+ "kind": "NON_NULL",
12116
+ "name": null,
12117
+ "ofType": {
12118
+ "kind": "OBJECT",
12119
+ "name": "ShippingPdfFormat",
12120
+ "ofType": null
12121
+ }
12122
+ }
12123
+ }
12124
+ },
12125
+ "isDeprecated": false,
12126
+ "deprecationReason": null
12127
+ },
12013
12128
  {
12014
12129
  "name": "dhlSettings",
12015
12130
  "description": "Get DHL extended settings (services, boxes, label sizes, currencies, regions, package types, countries).",
@@ -12866,6 +12981,47 @@
12866
12981
  "isDeprecated": false,
12867
12982
  "deprecationReason": null
12868
12983
  },
12984
+ {
12985
+ "name": "shippingWaybillSchema",
12986
+ "description": "Describe the full input schema for generating a waybill with a specific shipping provider. Call this before `createShippingWaybill` to discover provider-specific fields, validation rules, dependencies and example values. The schema is auto-generated from the provider's own WaybillRequest rules and Manager metadata, so newly added providers are supported without any GraphQL changes.",
12987
+ "args": [
12988
+ {
12989
+ "name": "key",
12990
+ "description": "Provider app key (e.g. 'econt', 'speedy', 'dpdbulgaria').",
12991
+ "type": {
12992
+ "kind": "NON_NULL",
12993
+ "name": null,
12994
+ "ofType": {
12995
+ "kind": "SCALAR",
12996
+ "name": "String",
12997
+ "ofType": null
12998
+ }
12999
+ },
13000
+ "defaultValue": null
13001
+ },
13002
+ {
13003
+ "name": "orderId",
13004
+ "description": "Optional order ID. When provided, schema is order-aware (e.g. service options are actual calculated options, pallet-flag reflects provider settings, COD default is the order's COD total).",
13005
+ "type": {
13006
+ "kind": "SCALAR",
13007
+ "name": "ID",
13008
+ "ofType": null
13009
+ },
13010
+ "defaultValue": null
13011
+ }
13012
+ ],
13013
+ "type": {
13014
+ "kind": "NON_NULL",
13015
+ "name": null,
13016
+ "ofType": {
13017
+ "kind": "OBJECT",
13018
+ "name": "ShippingWaybillSchema",
13019
+ "ofType": null
13020
+ }
13021
+ },
13022
+ "isDeprecated": false,
13023
+ "deprecationReason": null
13024
+ },
12869
13025
  {
12870
13026
  "name": "nitroStorefronts",
12871
13027
  "description": "List all Nitro storefronts for the current store.",
@@ -15676,6 +15832,47 @@
15676
15832
  "isDeprecated": false,
15677
15833
  "deprecationReason": null
15678
15834
  },
15835
+ {
15836
+ "name": "sendManualOrderCheckoutLink",
15837
+ "description": "Send the checkout link for a manually-created order to the customer by email. Used when the order is a manual draft paid with an online payment provider — the customer receives a link to complete the payment themselves. Mirrors the admin UI's `send_confirmed_order` / `send_notification_url` buttons on the order detail page.",
15838
+ "args": [
15839
+ {
15840
+ "name": "id",
15841
+ "description": "Order ID.",
15842
+ "type": {
15843
+ "kind": "NON_NULL",
15844
+ "name": null,
15845
+ "ofType": {
15846
+ "kind": "SCALAR",
15847
+ "name": "ID",
15848
+ "ofType": null
15849
+ }
15850
+ },
15851
+ "defaultValue": null
15852
+ },
15853
+ {
15854
+ "name": "confirm",
15855
+ "description": "When true, also confirm the order (removes is_draft meta). Mirrors the admin flow's `is_confirmed=1` flag. Default: true.",
15856
+ "type": {
15857
+ "kind": "SCALAR",
15858
+ "name": "Boolean",
15859
+ "ofType": null
15860
+ },
15861
+ "defaultValue": "true"
15862
+ }
15863
+ ],
15864
+ "type": {
15865
+ "kind": "NON_NULL",
15866
+ "name": null,
15867
+ "ofType": {
15868
+ "kind": "OBJECT",
15869
+ "name": "Order",
15870
+ "ofType": null
15871
+ }
15872
+ },
15873
+ "isDeprecated": false,
15874
+ "deprecationReason": null
15875
+ },
15679
15876
  {
15680
15877
  "name": "generateInvoiceNumber",
15681
15878
  "description": "Generate an invoice number for an order.",
@@ -35454,6 +35651,16 @@
35454
35651
  }
35455
35652
  },
35456
35653
  "defaultValue": null
35654
+ },
35655
+ {
35656
+ "name": "autoFulfill",
35657
+ "description": "Automatically mark order as fulfilled (shipped) after generating waybill.",
35658
+ "type": {
35659
+ "kind": "SCALAR",
35660
+ "name": "Boolean",
35661
+ "ofType": null
35662
+ },
35663
+ "defaultValue": "false"
35457
35664
  }
35458
35665
  ],
35459
35666
  "type": {
@@ -35469,26 +35676,26 @@
35469
35676
  "deprecationReason": null
35470
35677
  },
35471
35678
  {
35472
- "name": "calculateShipping",
35473
- "description": "Calculate shipping rates for an order.",
35679
+ "name": "changeOrderShippingProvider",
35680
+ "description": "Change the shipping provider on an order. Mirrors the admin UI's 'Change shipping provider' flow: swaps the provider, recreates shipping-related taxes for the new zone, and fires the OrderShippingChange event. To swap the provider without recalculating any part of the shipping price, use `swapOrderShippingProvider` instead.",
35474
35681
  "args": [
35475
35682
  {
35476
- "name": "key",
35477
- "description": "The shipping provider app key.",
35683
+ "name": "orderId",
35684
+ "description": "Order ID.",
35478
35685
  "type": {
35479
35686
  "kind": "NON_NULL",
35480
35687
  "name": null,
35481
35688
  "ofType": {
35482
35689
  "kind": "SCALAR",
35483
- "name": "String",
35690
+ "name": "ID",
35484
35691
  "ofType": null
35485
35692
  }
35486
35693
  },
35487
35694
  "defaultValue": null
35488
35695
  },
35489
35696
  {
35490
- "name": "orderId",
35491
- "description": "Order ID.",
35697
+ "name": "shippingProviderId",
35698
+ "description": "ID of the new shipping provider. Must belong to the current site.",
35492
35699
  "type": {
35493
35700
  "kind": "NON_NULL",
35494
35701
  "name": null,
@@ -35501,11 +35708,11 @@
35501
35708
  "defaultValue": null
35502
35709
  },
35503
35710
  {
35504
- "name": "input",
35505
- "description": "Calculation parameters.",
35711
+ "name": "pickupPointId",
35712
+ "description": "Optional pickup point id (office/locker/marketplace) if the new provider requires one. When omitted and the provider needs a pickup, the mutation returns `requiresPickup=true` with the expected `pickupType` so the agent can re-invoke with the id.",
35506
35713
  "type": {
35507
- "kind": "INPUT_OBJECT",
35508
- "name": "ShippingCalculateInput",
35714
+ "kind": "SCALAR",
35715
+ "name": "String",
35509
35716
  "ofType": null
35510
35717
  },
35511
35718
  "defaultValue": null
@@ -35515,40 +35722,18 @@
35515
35722
  "kind": "NON_NULL",
35516
35723
  "name": null,
35517
35724
  "ofType": {
35518
- "kind": "LIST",
35519
- "name": null,
35520
- "ofType": {
35521
- "kind": "NON_NULL",
35522
- "name": null,
35523
- "ofType": {
35524
- "kind": "OBJECT",
35525
- "name": "ShippingCalculation",
35526
- "ofType": null
35527
- }
35528
- }
35725
+ "kind": "OBJECT",
35726
+ "name": "ChangeShippingProviderResult",
35727
+ "ofType": null
35529
35728
  }
35530
35729
  },
35531
35730
  "isDeprecated": false,
35532
35731
  "deprecationReason": null
35533
35732
  },
35534
35733
  {
35535
- "name": "changeShippingPickup",
35536
- "description": "Change the pickup point for an order's shipment.",
35734
+ "name": "swapOrderShippingProvider",
35735
+ "description": "Swap the shipping provider on an order WITHOUT recalculating the shipping price. The entire shipping price breakdown (order_amount, provider_amount, VAT variants, insurance) is captured before and restored after the swap. Use this when the carrier changes but the customer has already been charged and the shipping total must not move. For a fresh quote from the new provider, use `changeOrderShippingProvider` instead.",
35537
35736
  "args": [
35538
- {
35539
- "name": "key",
35540
- "description": "The shipping provider app key.",
35541
- "type": {
35542
- "kind": "NON_NULL",
35543
- "name": null,
35544
- "ofType": {
35545
- "kind": "SCALAR",
35546
- "name": "String",
35547
- "ofType": null
35548
- }
35549
- },
35550
- "defaultValue": null
35551
- },
35552
35737
  {
35553
35738
  "name": "orderId",
35554
35739
  "description": "Order ID.",
@@ -35564,30 +35749,26 @@
35564
35749
  "defaultValue": null
35565
35750
  },
35566
35751
  {
35567
- "name": "type",
35568
- "description": "Pickup type.",
35752
+ "name": "shippingProviderId",
35753
+ "description": "ID of the new shipping provider. Must belong to the current site.",
35569
35754
  "type": {
35570
35755
  "kind": "NON_NULL",
35571
35756
  "name": null,
35572
35757
  "ofType": {
35573
- "kind": "ENUM",
35574
- "name": "ShippingPickupType",
35758
+ "kind": "SCALAR",
35759
+ "name": "ID",
35575
35760
  "ofType": null
35576
35761
  }
35577
35762
  },
35578
35763
  "defaultValue": null
35579
35764
  },
35580
35765
  {
35581
- "name": "input",
35582
- "description": "Pickup details.",
35766
+ "name": "pickupPointId",
35767
+ "description": "Optional pickup point id (office/locker/marketplace) if the new provider requires one. When omitted and the provider needs a pickup, the mutation returns `requiresPickup=true` with the expected `pickupType` so the agent can re-invoke with the id.",
35583
35768
  "type": {
35584
- "kind": "NON_NULL",
35585
- "name": null,
35586
- "ofType": {
35587
- "kind": "INPUT_OBJECT",
35588
- "name": "ShippingPickupInput",
35589
- "ofType": null
35590
- }
35769
+ "kind": "SCALAR",
35770
+ "name": "String",
35771
+ "ofType": null
35591
35772
  },
35592
35773
  "defaultValue": null
35593
35774
  }
@@ -35597,7 +35778,7 @@
35597
35778
  "name": null,
35598
35779
  "ofType": {
35599
35780
  "kind": "OBJECT",
35600
- "name": "ShippingMutationResult",
35781
+ "name": "ChangeShippingProviderResult",
35601
35782
  "ofType": null
35602
35783
  }
35603
35784
  },
@@ -35605,32 +35786,18 @@
35605
35786
  "deprecationReason": null
35606
35787
  },
35607
35788
  {
35608
- "name": "bulkPrintShippingWaybills",
35609
- "description": "Bulk print waybills for multiple orders.",
35789
+ "name": "cancelShippingWaybill",
35790
+ "description": "Cancel a waybill (bill of lading) for an order.",
35610
35791
  "args": [
35611
35792
  {
35612
- "name": "key",
35613
- "description": "The shipping provider app key.",
35793
+ "name": "orderId",
35794
+ "description": "Order ID.",
35614
35795
  "type": {
35615
35796
  "kind": "NON_NULL",
35616
35797
  "name": null,
35617
35798
  "ofType": {
35618
35799
  "kind": "SCALAR",
35619
- "name": "String",
35620
- "ofType": null
35621
- }
35622
- },
35623
- "defaultValue": null
35624
- },
35625
- {
35626
- "name": "input",
35627
- "description": "Print parameters.",
35628
- "type": {
35629
- "kind": "NON_NULL",
35630
- "name": null,
35631
- "ofType": {
35632
- "kind": "INPUT_OBJECT",
35633
- "name": "ShippingBulkPrintInput",
35800
+ "name": "ID",
35634
35801
  "ofType": null
35635
35802
  }
35636
35803
  },
@@ -35642,7 +35809,7 @@
35642
35809
  "name": null,
35643
35810
  "ofType": {
35644
35811
  "kind": "OBJECT",
35645
- "name": "ShippingBulkPrintResult",
35812
+ "name": "ShippingMutationResult",
35646
35813
  "ofType": null
35647
35814
  }
35648
35815
  },
@@ -35650,8 +35817,189 @@
35650
35817
  "deprecationReason": null
35651
35818
  },
35652
35819
  {
35653
- "name": "getShippingWaybillPdf",
35654
- "description": "Get the PDF for a specific order's waybill.",
35820
+ "name": "calculateShipping",
35821
+ "description": "Calculate shipping rates for an order.",
35822
+ "args": [
35823
+ {
35824
+ "name": "key",
35825
+ "description": "The shipping provider app key.",
35826
+ "type": {
35827
+ "kind": "NON_NULL",
35828
+ "name": null,
35829
+ "ofType": {
35830
+ "kind": "SCALAR",
35831
+ "name": "String",
35832
+ "ofType": null
35833
+ }
35834
+ },
35835
+ "defaultValue": null
35836
+ },
35837
+ {
35838
+ "name": "orderId",
35839
+ "description": "Order ID.",
35840
+ "type": {
35841
+ "kind": "NON_NULL",
35842
+ "name": null,
35843
+ "ofType": {
35844
+ "kind": "SCALAR",
35845
+ "name": "ID",
35846
+ "ofType": null
35847
+ }
35848
+ },
35849
+ "defaultValue": null
35850
+ },
35851
+ {
35852
+ "name": "input",
35853
+ "description": "Calculation parameters.",
35854
+ "type": {
35855
+ "kind": "INPUT_OBJECT",
35856
+ "name": "ShippingCalculateInput",
35857
+ "ofType": null
35858
+ },
35859
+ "defaultValue": null
35860
+ }
35861
+ ],
35862
+ "type": {
35863
+ "kind": "NON_NULL",
35864
+ "name": null,
35865
+ "ofType": {
35866
+ "kind": "LIST",
35867
+ "name": null,
35868
+ "ofType": {
35869
+ "kind": "NON_NULL",
35870
+ "name": null,
35871
+ "ofType": {
35872
+ "kind": "OBJECT",
35873
+ "name": "ShippingCalculation",
35874
+ "ofType": null
35875
+ }
35876
+ }
35877
+ }
35878
+ },
35879
+ "isDeprecated": false,
35880
+ "deprecationReason": null
35881
+ },
35882
+ {
35883
+ "name": "changeShippingPickup",
35884
+ "description": "Change the pickup point for an order's shipment.",
35885
+ "args": [
35886
+ {
35887
+ "name": "key",
35888
+ "description": "The shipping provider app key.",
35889
+ "type": {
35890
+ "kind": "NON_NULL",
35891
+ "name": null,
35892
+ "ofType": {
35893
+ "kind": "SCALAR",
35894
+ "name": "String",
35895
+ "ofType": null
35896
+ }
35897
+ },
35898
+ "defaultValue": null
35899
+ },
35900
+ {
35901
+ "name": "orderId",
35902
+ "description": "Order ID.",
35903
+ "type": {
35904
+ "kind": "NON_NULL",
35905
+ "name": null,
35906
+ "ofType": {
35907
+ "kind": "SCALAR",
35908
+ "name": "ID",
35909
+ "ofType": null
35910
+ }
35911
+ },
35912
+ "defaultValue": null
35913
+ },
35914
+ {
35915
+ "name": "type",
35916
+ "description": "Pickup type.",
35917
+ "type": {
35918
+ "kind": "NON_NULL",
35919
+ "name": null,
35920
+ "ofType": {
35921
+ "kind": "ENUM",
35922
+ "name": "ShippingPickupType",
35923
+ "ofType": null
35924
+ }
35925
+ },
35926
+ "defaultValue": null
35927
+ },
35928
+ {
35929
+ "name": "input",
35930
+ "description": "Pickup details.",
35931
+ "type": {
35932
+ "kind": "NON_NULL",
35933
+ "name": null,
35934
+ "ofType": {
35935
+ "kind": "INPUT_OBJECT",
35936
+ "name": "ShippingPickupInput",
35937
+ "ofType": null
35938
+ }
35939
+ },
35940
+ "defaultValue": null
35941
+ }
35942
+ ],
35943
+ "type": {
35944
+ "kind": "NON_NULL",
35945
+ "name": null,
35946
+ "ofType": {
35947
+ "kind": "OBJECT",
35948
+ "name": "ShippingMutationResult",
35949
+ "ofType": null
35950
+ }
35951
+ },
35952
+ "isDeprecated": false,
35953
+ "deprecationReason": null
35954
+ },
35955
+ {
35956
+ "name": "bulkPrintShippingWaybills",
35957
+ "description": "Bulk print waybills for multiple orders.",
35958
+ "args": [
35959
+ {
35960
+ "name": "key",
35961
+ "description": "The shipping provider app key.",
35962
+ "type": {
35963
+ "kind": "NON_NULL",
35964
+ "name": null,
35965
+ "ofType": {
35966
+ "kind": "SCALAR",
35967
+ "name": "String",
35968
+ "ofType": null
35969
+ }
35970
+ },
35971
+ "defaultValue": null
35972
+ },
35973
+ {
35974
+ "name": "input",
35975
+ "description": "Print parameters.",
35976
+ "type": {
35977
+ "kind": "NON_NULL",
35978
+ "name": null,
35979
+ "ofType": {
35980
+ "kind": "INPUT_OBJECT",
35981
+ "name": "ShippingBulkPrintInput",
35982
+ "ofType": null
35983
+ }
35984
+ },
35985
+ "defaultValue": null
35986
+ }
35987
+ ],
35988
+ "type": {
35989
+ "kind": "NON_NULL",
35990
+ "name": null,
35991
+ "ofType": {
35992
+ "kind": "OBJECT",
35993
+ "name": "ShippingBulkPrintResult",
35994
+ "ofType": null
35995
+ }
35996
+ },
35997
+ "isDeprecated": false,
35998
+ "deprecationReason": null
35999
+ },
36000
+ {
36001
+ "name": "getShippingWaybillPdf",
36002
+ "description": "Get the PDF for a specific order's waybill.",
35655
36003
  "args": [
35656
36004
  {
35657
36005
  "name": "key",
@@ -38403,7 +38751,7 @@
38403
38751
  {
38404
38752
  "kind": "OBJECT",
38405
38753
  "name": "OrderPayment",
38406
- "description": "A payment record for an order.",
38754
+ "description": "A payment record for an order. This is the storefront-side view — for the full gateway record with provider_data, capture/refund history and raw provider response, read `gatewayPayment`.",
38407
38755
  "fields": [
38408
38756
  {
38409
38757
  "name": "id",
@@ -38439,7 +38787,7 @@
38439
38787
  },
38440
38788
  {
38441
38789
  "name": "provider",
38442
- "description": "Payment provider key.",
38790
+ "description": "Payment provider key (e.g. 'cod', 'stripe', 'borica_way4', 'paypal').",
38443
38791
  "args": [],
38444
38792
  "type": {
38445
38793
  "kind": "SCALAR",
@@ -38487,7 +38835,7 @@
38487
38835
  },
38488
38836
  {
38489
38837
  "name": "status",
38490
- "description": "Payment status.",
38838
+ "description": "Payment status: initiated | requested | pending | completed | authorized | refunded | cancelled | failed | timeouted.",
38491
38839
  "args": [],
38492
38840
  "type": {
38493
38841
  "kind": "SCALAR",
@@ -38532,6 +38880,86 @@
38532
38880
  },
38533
38881
  "isDeprecated": false,
38534
38882
  "deprecationReason": null
38883
+ },
38884
+ {
38885
+ "name": "gatewayPayment",
38886
+ "description": "Gateway-side payment record — contains raw provider response data, authorize amount, currency, and history. Null until the payment has been initiated on the gateway.",
38887
+ "args": [],
38888
+ "type": {
38889
+ "kind": "OBJECT",
38890
+ "name": "PaymentGatewayRecord",
38891
+ "ofType": null
38892
+ },
38893
+ "isDeprecated": false,
38894
+ "deprecationReason": null
38895
+ },
38896
+ {
38897
+ "name": "providerType",
38898
+ "description": "Payment provider type(s): e.g. offline, online, credit. Used by the admin UI to show/hide Mark-as-paid, Capture and Refund buttons.",
38899
+ "args": [],
38900
+ "type": {
38901
+ "kind": "LIST",
38902
+ "name": null,
38903
+ "ofType": {
38904
+ "kind": "NON_NULL",
38905
+ "name": null,
38906
+ "ofType": {
38907
+ "kind": "SCALAR",
38908
+ "name": "String",
38909
+ "ofType": null
38910
+ }
38911
+ }
38912
+ },
38913
+ "isDeprecated": false,
38914
+ "deprecationReason": null
38915
+ },
38916
+ {
38917
+ "name": "isOffline",
38918
+ "description": "True when the payment is an offline/manual one (COD, bank transfer) — enables `markPaymentPaid` mutation.",
38919
+ "args": [],
38920
+ "type": {
38921
+ "kind": "NON_NULL",
38922
+ "name": null,
38923
+ "ofType": {
38924
+ "kind": "SCALAR",
38925
+ "name": "Boolean",
38926
+ "ofType": null
38927
+ }
38928
+ },
38929
+ "isDeprecated": false,
38930
+ "deprecationReason": null
38931
+ },
38932
+ {
38933
+ "name": "canCapture",
38934
+ "description": "True when the payment has been authorized and can be captured via `capturePayment` (or cancelled via `cancelPayment`).",
38935
+ "args": [],
38936
+ "type": {
38937
+ "kind": "NON_NULL",
38938
+ "name": null,
38939
+ "ofType": {
38940
+ "kind": "SCALAR",
38941
+ "name": "Boolean",
38942
+ "ofType": null
38943
+ }
38944
+ },
38945
+ "isDeprecated": false,
38946
+ "deprecationReason": null
38947
+ },
38948
+ {
38949
+ "name": "canRefund",
38950
+ "description": "True when the payment is completed and can be refunded via `refundPayment`.",
38951
+ "args": [],
38952
+ "type": {
38953
+ "kind": "NON_NULL",
38954
+ "name": null,
38955
+ "ofType": {
38956
+ "kind": "SCALAR",
38957
+ "name": "Boolean",
38958
+ "ofType": null
38959
+ }
38960
+ },
38961
+ "isDeprecated": false,
38962
+ "deprecationReason": null
38535
38963
  }
38536
38964
  ],
38537
38965
  "inputFields": null,
@@ -38541,12 +38969,12 @@
38541
38969
  },
38542
38970
  {
38543
38971
  "kind": "OBJECT",
38544
- "name": "OrderShipping",
38545
- "description": "Shipping information for an order.",
38972
+ "name": "PaymentGatewayRecord",
38973
+ "description": "Full gateway-side payment record — exposes the raw provider data and authorization lifecycle details not captured on OrderPayment itself.",
38546
38974
  "fields": [
38547
38975
  {
38548
38976
  "name": "id",
38549
- "description": "Unique identifier.",
38977
+ "description": "Gateway payment ID.",
38550
38978
  "args": [],
38551
38979
  "type": {
38552
38980
  "kind": "NON_NULL",
@@ -38561,48 +38989,56 @@
38561
38989
  "deprecationReason": null
38562
38990
  },
38563
38991
  {
38564
- "name": "orderId",
38565
- "description": "Parent order ID.",
38992
+ "name": "provider",
38993
+ "description": "Provider key (e.g. 'stripe', 'borica_way4', 'cod').",
38566
38994
  "args": [],
38567
38995
  "type": {
38568
- "kind": "NON_NULL",
38569
- "name": null,
38570
- "ofType": {
38571
- "kind": "SCALAR",
38572
- "name": "ID",
38573
- "ofType": null
38574
- }
38996
+ "kind": "SCALAR",
38997
+ "name": "String",
38998
+ "ofType": null
38575
38999
  },
38576
39000
  "isDeprecated": false,
38577
39001
  "deprecationReason": null
38578
39002
  },
38579
39003
  {
38580
- "name": "providerId",
38581
- "description": "Shipping provider ID.",
39004
+ "name": "siteReferenceId",
39005
+ "description": "Order-payment reference (maps back to OrderPayment.id).",
38582
39006
  "args": [],
38583
39007
  "type": {
38584
39008
  "kind": "SCALAR",
38585
- "name": "ID",
39009
+ "name": "String",
38586
39010
  "ofType": null
38587
39011
  },
38588
39012
  "isDeprecated": false,
38589
39013
  "deprecationReason": null
38590
39014
  },
38591
39015
  {
38592
- "name": "serviceId",
38593
- "description": "Shipping service ID.",
39016
+ "name": "providerReferenceId",
39017
+ "description": "Provider-issued reference id (transaction id, charge id, etc.).",
38594
39018
  "args": [],
38595
39019
  "type": {
38596
39020
  "kind": "SCALAR",
38597
- "name": "ID",
39021
+ "name": "String",
38598
39022
  "ofType": null
38599
39023
  },
38600
39024
  "isDeprecated": false,
38601
39025
  "deprecationReason": null
38602
39026
  },
38603
39027
  {
38604
- "name": "serviceName",
38605
- "description": "Shipping service name.",
39028
+ "name": "amount",
39029
+ "description": "Payment amount in minor units (e.g. stotinki).",
39030
+ "args": [],
39031
+ "type": {
39032
+ "kind": "SCALAR",
39033
+ "name": "Int",
39034
+ "ofType": null
39035
+ },
39036
+ "isDeprecated": false,
39037
+ "deprecationReason": null
39038
+ },
39039
+ {
39040
+ "name": "currency",
39041
+ "description": "Currency ISO code (e.g. BGN, EUR, USD).",
38606
39042
  "args": [],
38607
39043
  "type": {
38608
39044
  "kind": "SCALAR",
@@ -38613,8 +39049,20 @@
38613
39049
  "deprecationReason": null
38614
39050
  },
38615
39051
  {
38616
- "name": "providerName",
38617
- "description": "Shipping provider name.",
39052
+ "name": "authorizeAmount",
39053
+ "description": "Authorized amount — set when the provider supports auth+capture, 0/null otherwise.",
39054
+ "args": [],
39055
+ "type": {
39056
+ "kind": "SCALAR",
39057
+ "name": "Int",
39058
+ "ofType": null
39059
+ },
39060
+ "isDeprecated": false,
39061
+ "deprecationReason": null
39062
+ },
39063
+ {
39064
+ "name": "status",
39065
+ "description": "Payment status — follows the same vocabulary as OrderPayment.status.",
38618
39066
  "args": [],
38619
39067
  "type": {
38620
39068
  "kind": "SCALAR",
@@ -38625,8 +39073,8 @@
38625
39073
  "deprecationReason": null
38626
39074
  },
38627
39075
  {
38628
- "name": "providerType",
38629
- "description": "Shipping provider type/integration key.",
39076
+ "name": "invoice",
39077
+ "description": "Invoice reference, if issued.",
38630
39078
  "args": [],
38631
39079
  "type": {
38632
39080
  "kind": "SCALAR",
@@ -38637,8 +39085,8 @@
38637
39085
  "deprecationReason": null
38638
39086
  },
38639
39087
  {
38640
- "name": "providerFrom",
38641
- "description": "Pickup/origin location.",
39088
+ "name": "clientEmail",
39089
+ "description": "Client email used when initiating the payment.",
38642
39090
  "args": [],
38643
39091
  "type": {
38644
39092
  "kind": "SCALAR",
@@ -38649,8 +39097,8 @@
38649
39097
  "deprecationReason": null
38650
39098
  },
38651
39099
  {
38652
- "name": "providerTo",
38653
- "description": "Delivery location.",
39100
+ "name": "country",
39101
+ "description": "Billing country.",
38654
39102
  "args": [],
38655
39103
  "type": {
38656
39104
  "kind": "SCALAR",
@@ -38661,36 +39109,36 @@
38661
39109
  "deprecationReason": null
38662
39110
  },
38663
39111
  {
38664
- "name": "orderAmount",
38665
- "description": "Order-side shipping amount (converted from cents).",
39112
+ "name": "providerData",
39113
+ "description": "Raw provider-specific data (JSON). May contain PCI-sensitive fields — prefer explicit fields above when available.",
38666
39114
  "args": [],
38667
39115
  "type": {
38668
39116
  "kind": "SCALAR",
38669
- "name": "Float",
39117
+ "name": "JSON",
38670
39118
  "ofType": null
38671
39119
  },
38672
39120
  "isDeprecated": false,
38673
39121
  "deprecationReason": null
38674
39122
  },
38675
39123
  {
38676
- "name": "providerAmount",
38677
- "description": "Provider-side shipping amount (converted from cents).",
39124
+ "name": "dateRequested",
39125
+ "description": "When the payment was first requested from the provider.",
38678
39126
  "args": [],
38679
39127
  "type": {
38680
39128
  "kind": "SCALAR",
38681
- "name": "Float",
39129
+ "name": "DateTime",
38682
39130
  "ofType": null
38683
39131
  },
38684
39132
  "isDeprecated": false,
38685
39133
  "deprecationReason": null
38686
39134
  },
38687
39135
  {
38688
- "name": "providerInsurance",
38689
- "description": "Provider insurance amount (converted from cents).",
39136
+ "name": "dateLastUpdated",
39137
+ "description": "When the record was last updated.",
38690
39138
  "args": [],
38691
39139
  "type": {
38692
39140
  "kind": "SCALAR",
38693
- "name": "Float",
39141
+ "name": "DateTime",
38694
39142
  "ofType": null
38695
39143
  },
38696
39144
  "isDeprecated": false,
@@ -38704,8 +39152,171 @@
38704
39152
  },
38705
39153
  {
38706
39154
  "kind": "OBJECT",
38707
- "name": "ShippingAddress",
38708
- "description": "Shipping address for an order.",
39155
+ "name": "OrderShipping",
39156
+ "description": "Shipping information for an order.",
39157
+ "fields": [
39158
+ {
39159
+ "name": "id",
39160
+ "description": "Unique identifier.",
39161
+ "args": [],
39162
+ "type": {
39163
+ "kind": "NON_NULL",
39164
+ "name": null,
39165
+ "ofType": {
39166
+ "kind": "SCALAR",
39167
+ "name": "ID",
39168
+ "ofType": null
39169
+ }
39170
+ },
39171
+ "isDeprecated": false,
39172
+ "deprecationReason": null
39173
+ },
39174
+ {
39175
+ "name": "orderId",
39176
+ "description": "Parent order ID.",
39177
+ "args": [],
39178
+ "type": {
39179
+ "kind": "NON_NULL",
39180
+ "name": null,
39181
+ "ofType": {
39182
+ "kind": "SCALAR",
39183
+ "name": "ID",
39184
+ "ofType": null
39185
+ }
39186
+ },
39187
+ "isDeprecated": false,
39188
+ "deprecationReason": null
39189
+ },
39190
+ {
39191
+ "name": "providerId",
39192
+ "description": "Shipping provider ID.",
39193
+ "args": [],
39194
+ "type": {
39195
+ "kind": "SCALAR",
39196
+ "name": "ID",
39197
+ "ofType": null
39198
+ },
39199
+ "isDeprecated": false,
39200
+ "deprecationReason": null
39201
+ },
39202
+ {
39203
+ "name": "serviceId",
39204
+ "description": "Shipping service ID.",
39205
+ "args": [],
39206
+ "type": {
39207
+ "kind": "SCALAR",
39208
+ "name": "ID",
39209
+ "ofType": null
39210
+ },
39211
+ "isDeprecated": false,
39212
+ "deprecationReason": null
39213
+ },
39214
+ {
39215
+ "name": "serviceName",
39216
+ "description": "Shipping service name.",
39217
+ "args": [],
39218
+ "type": {
39219
+ "kind": "SCALAR",
39220
+ "name": "String",
39221
+ "ofType": null
39222
+ },
39223
+ "isDeprecated": false,
39224
+ "deprecationReason": null
39225
+ },
39226
+ {
39227
+ "name": "providerName",
39228
+ "description": "Shipping provider name.",
39229
+ "args": [],
39230
+ "type": {
39231
+ "kind": "SCALAR",
39232
+ "name": "String",
39233
+ "ofType": null
39234
+ },
39235
+ "isDeprecated": false,
39236
+ "deprecationReason": null
39237
+ },
39238
+ {
39239
+ "name": "providerType",
39240
+ "description": "Shipping provider type/integration key.",
39241
+ "args": [],
39242
+ "type": {
39243
+ "kind": "SCALAR",
39244
+ "name": "String",
39245
+ "ofType": null
39246
+ },
39247
+ "isDeprecated": false,
39248
+ "deprecationReason": null
39249
+ },
39250
+ {
39251
+ "name": "providerFrom",
39252
+ "description": "Pickup/origin location.",
39253
+ "args": [],
39254
+ "type": {
39255
+ "kind": "SCALAR",
39256
+ "name": "String",
39257
+ "ofType": null
39258
+ },
39259
+ "isDeprecated": false,
39260
+ "deprecationReason": null
39261
+ },
39262
+ {
39263
+ "name": "providerTo",
39264
+ "description": "Delivery location.",
39265
+ "args": [],
39266
+ "type": {
39267
+ "kind": "SCALAR",
39268
+ "name": "String",
39269
+ "ofType": null
39270
+ },
39271
+ "isDeprecated": false,
39272
+ "deprecationReason": null
39273
+ },
39274
+ {
39275
+ "name": "orderAmount",
39276
+ "description": "Order-side shipping amount (converted from cents).",
39277
+ "args": [],
39278
+ "type": {
39279
+ "kind": "SCALAR",
39280
+ "name": "Float",
39281
+ "ofType": null
39282
+ },
39283
+ "isDeprecated": false,
39284
+ "deprecationReason": null
39285
+ },
39286
+ {
39287
+ "name": "providerAmount",
39288
+ "description": "Provider-side shipping amount (converted from cents).",
39289
+ "args": [],
39290
+ "type": {
39291
+ "kind": "SCALAR",
39292
+ "name": "Float",
39293
+ "ofType": null
39294
+ },
39295
+ "isDeprecated": false,
39296
+ "deprecationReason": null
39297
+ },
39298
+ {
39299
+ "name": "providerInsurance",
39300
+ "description": "Provider insurance amount (converted from cents).",
39301
+ "args": [],
39302
+ "type": {
39303
+ "kind": "SCALAR",
39304
+ "name": "Float",
39305
+ "ofType": null
39306
+ },
39307
+ "isDeprecated": false,
39308
+ "deprecationReason": null
39309
+ }
39310
+ ],
39311
+ "inputFields": null,
39312
+ "interfaces": [],
39313
+ "enumValues": null,
39314
+ "possibleTypes": null
39315
+ },
39316
+ {
39317
+ "kind": "OBJECT",
39318
+ "name": "ShippingAddress",
39319
+ "description": "Shipping address for an order.",
38709
39320
  "fields": [
38710
39321
  {
38711
39322
  "name": "id",
@@ -41007,6 +41618,73 @@
41007
41618
  "ofType": null
41008
41619
  },
41009
41620
  "defaultValue": null
41621
+ },
41622
+ {
41623
+ "name": "discount_value",
41624
+ "description": "New discount value to apply to the existing line discount. Scoped to `discounts.global.type_value` — only applies if the product already has a discount. Format: absolute currency amount for flat/fixed discounts, percentage for percent discounts.",
41625
+ "type": {
41626
+ "kind": "SCALAR",
41627
+ "name": "Float",
41628
+ "ofType": null
41629
+ },
41630
+ "defaultValue": null
41631
+ },
41632
+ {
41633
+ "name": "options",
41634
+ "description": "Updates to individual product options on this line item. Use the option `id` from `OrderProduct.options`. Each option`s `discount_price` follows its amount type (percent vs absolute).",
41635
+ "type": {
41636
+ "kind": "LIST",
41637
+ "name": null,
41638
+ "ofType": {
41639
+ "kind": "NON_NULL",
41640
+ "name": null,
41641
+ "ofType": {
41642
+ "kind": "INPUT_OBJECT",
41643
+ "name": "UpdateOrderProductOptionInput",
41644
+ "ofType": null
41645
+ }
41646
+ }
41647
+ },
41648
+ "defaultValue": null
41649
+ }
41650
+ ],
41651
+ "interfaces": null,
41652
+ "enumValues": null,
41653
+ "possibleTypes": null
41654
+ },
41655
+ {
41656
+ "kind": "INPUT_OBJECT",
41657
+ "name": "UpdateOrderProductOptionInput",
41658
+ "description": "Update a single option`s price/amount on an order line item.",
41659
+ "fields": null,
41660
+ "inputFields": [
41661
+ {
41662
+ "name": "id",
41663
+ "description": "Option ID (from OrderProduct.options[].id).",
41664
+ "type": {
41665
+ "kind": "NON_NULL",
41666
+ "name": null,
41667
+ "ofType": {
41668
+ "kind": "SCALAR",
41669
+ "name": "ID",
41670
+ "ofType": null
41671
+ }
41672
+ },
41673
+ "defaultValue": null
41674
+ },
41675
+ {
41676
+ "name": "discount_price",
41677
+ "description": "Option price override. For options with `amount_type = percent`, this is a percentage value (0..100). For absolute options, this is a currency amount.",
41678
+ "type": {
41679
+ "kind": "NON_NULL",
41680
+ "name": null,
41681
+ "ofType": {
41682
+ "kind": "SCALAR",
41683
+ "name": "Float",
41684
+ "ofType": null
41685
+ }
41686
+ },
41687
+ "defaultValue": null
41010
41688
  }
41011
41689
  ],
41012
41690
  "interfaces": null,
@@ -41117,12 +41795,77 @@
41117
41795
  "enumValues": null,
41118
41796
  "possibleTypes": null
41119
41797
  },
41798
+ {
41799
+ "kind": "ENUM",
41800
+ "name": "ShippingDeliveryType",
41801
+ "description": "Type of delivery destination on an order. Determines which fields are written to the shipping address and which are cleared. When omitted from UpdateShippingAddressInput, the resolver infers from supplied fields (office_id -> OFFICE/LOCKER per office_type; marketplace_id -> MARKETPLACE; street_name or street_number -> ADDRESS).",
41802
+ "fields": null,
41803
+ "inputFields": null,
41804
+ "interfaces": null,
41805
+ "enumValues": [
41806
+ {
41807
+ "name": "ADDRESS",
41808
+ "description": "Door-to-door delivery to a street address. Clears office/locker/marketplace data.",
41809
+ "isDeprecated": false,
41810
+ "deprecationReason": null
41811
+ },
41812
+ {
41813
+ "name": "OFFICE",
41814
+ "description": "Delivery to the provider's office. Sets office_id + office_type=0, clears street + marketplace.",
41815
+ "isDeprecated": false,
41816
+ "deprecationReason": null
41817
+ },
41818
+ {
41819
+ "name": "LOCKER",
41820
+ "description": "Delivery to a parcel locker. Sets office_id + office_type=1, clears street + marketplace.",
41821
+ "isDeprecated": false,
41822
+ "deprecationReason": null
41823
+ },
41824
+ {
41825
+ "name": "MARKETPLACE",
41826
+ "description": "Delivery to a marketplace pickup point. Sets marketplace fields, clears office + street.",
41827
+ "isDeprecated": false,
41828
+ "deprecationReason": null
41829
+ }
41830
+ ],
41831
+ "possibleTypes": null
41832
+ },
41120
41833
  {
41121
41834
  "kind": "INPUT_OBJECT",
41122
41835
  "name": "UpdateShippingAddressInput",
41123
41836
  "description": "Input for updating a shipping address.",
41124
41837
  "fields": null,
41125
41838
  "inputFields": [
41839
+ {
41840
+ "name": "delivery_type",
41841
+ "description": "Delivery type. If omitted, inferred from which fields are supplied. Choosing ADDRESS clears office/marketplace; choosing OFFICE/LOCKER clears street/marketplace; choosing MARKETPLACE clears the rest. This prevents stale data when switching between pickup modes.",
41842
+ "type": {
41843
+ "kind": "ENUM",
41844
+ "name": "ShippingDeliveryType",
41845
+ "ofType": null
41846
+ },
41847
+ "defaultValue": null
41848
+ },
41849
+ {
41850
+ "name": "marketplace_id",
41851
+ "description": "Marketplace pickup point id (used with delivery_type: MARKETPLACE).",
41852
+ "type": {
41853
+ "kind": "SCALAR",
41854
+ "name": "String",
41855
+ "ofType": null
41856
+ },
41857
+ "defaultValue": null
41858
+ },
41859
+ {
41860
+ "name": "marketplace_name",
41861
+ "description": "Marketplace pickup point name (used with delivery_type: MARKETPLACE).",
41862
+ "type": {
41863
+ "kind": "SCALAR",
41864
+ "name": "String",
41865
+ "ofType": null
41866
+ },
41867
+ "defaultValue": null
41868
+ },
41126
41869
  {
41127
41870
  "name": "first_name",
41128
41871
  "description": "First name.",
@@ -108095,6 +108838,30 @@
108095
108838
  },
108096
108839
  "isDeprecated": false,
108097
108840
  "deprecationReason": null
108841
+ },
108842
+ {
108843
+ "name": "countryIso2",
108844
+ "description": "ISO 3166-1 alpha-2 country code (when the provider exposes it).",
108845
+ "args": [],
108846
+ "type": {
108847
+ "kind": "SCALAR",
108848
+ "name": "String",
108849
+ "ofType": null
108850
+ },
108851
+ "isDeprecated": false,
108852
+ "deprecationReason": null
108853
+ },
108854
+ {
108855
+ "name": "countryName",
108856
+ "description": "Localised country name (when the provider exposes it).",
108857
+ "args": [],
108858
+ "type": {
108859
+ "kind": "SCALAR",
108860
+ "name": "String",
108861
+ "ofType": null
108862
+ },
108863
+ "isDeprecated": false,
108864
+ "deprecationReason": null
108098
108865
  }
108099
108866
  ],
108100
108867
  "inputFields": null,
@@ -108724,19 +109491,19 @@
108724
109491
  },
108725
109492
  {
108726
109493
  "kind": "OBJECT",
108727
- "name": "GlovoShop",
108728
- "description": "A Glovo store/shop location.",
109494
+ "name": "ChangeShippingProviderResult",
109495
+ "description": "Result of changing the shipping provider on an order.",
108729
109496
  "fields": [
108730
109497
  {
108731
- "name": "id",
108732
- "description": "Shop ID.",
109498
+ "name": "success",
109499
+ "description": "Whether the provider was successfully changed.",
108733
109500
  "args": [],
108734
109501
  "type": {
108735
109502
  "kind": "NON_NULL",
108736
109503
  "name": null,
108737
109504
  "ofType": {
108738
109505
  "kind": "SCALAR",
108739
- "name": "ID",
109506
+ "name": "Boolean",
108740
109507
  "ofType": null
108741
109508
  }
108742
109509
  },
@@ -108744,8 +109511,8 @@
108744
109511
  "deprecationReason": null
108745
109512
  },
108746
109513
  {
108747
- "name": "title",
108748
- "description": "Shop title.",
109514
+ "name": "message",
109515
+ "description": "Human-readable message. Null on success.",
108749
109516
  "args": [],
108750
109517
  "type": {
108751
109518
  "kind": "SCALAR",
@@ -108756,8 +109523,36 @@
108756
109523
  "deprecationReason": null
108757
109524
  },
108758
109525
  {
108759
- "name": "email",
108760
- "description": "Shop email.",
109526
+ "name": "requiresPickup",
109527
+ "description": "True if the new provider requires a pickup selection (office/locker/marketplace/address) and none was supplied. The agent should retrieve the pickup list and re-invoke the mutation with `pickupPointId`.",
109528
+ "args": [],
109529
+ "type": {
109530
+ "kind": "NON_NULL",
109531
+ "name": null,
109532
+ "ofType": {
109533
+ "kind": "SCALAR",
109534
+ "name": "Boolean",
109535
+ "ofType": null
109536
+ }
109537
+ },
109538
+ "isDeprecated": false,
109539
+ "deprecationReason": null
109540
+ },
109541
+ {
109542
+ "name": "pickupType",
109543
+ "description": "When `requiresPickup` is true, the type of pickup expected.",
109544
+ "args": [],
109545
+ "type": {
109546
+ "kind": "ENUM",
109547
+ "name": "ShippingProviderPickupType",
109548
+ "ofType": null
109549
+ },
109550
+ "isDeprecated": false,
109551
+ "deprecationReason": null
109552
+ },
109553
+ {
109554
+ "name": "newProviderKey",
109555
+ "description": "Key of the new provider (e.g. 'econt', 'speedy'). Null if swap did not happen.",
108761
109556
  "args": [],
108762
109557
  "type": {
108763
109558
  "kind": "SCALAR",
@@ -108768,20 +109563,32 @@
108768
109563
  "deprecationReason": null
108769
109564
  },
108770
109565
  {
108771
- "name": "phone",
108772
- "description": "Shop phone number.",
109566
+ "name": "shippingAmount",
109567
+ "description": "Resulting shipping amount on the order after the swap.",
108773
109568
  "args": [],
108774
109569
  "type": {
108775
109570
  "kind": "SCALAR",
108776
- "name": "String",
109571
+ "name": "Float",
108777
109572
  "ofType": null
108778
109573
  },
108779
109574
  "isDeprecated": false,
108780
109575
  "deprecationReason": null
108781
109576
  },
108782
109577
  {
108783
- "name": "active",
108784
- "description": "Whether the shop is active.",
109578
+ "name": "previousShippingAmount",
109579
+ "description": "The shipping amount before the swap. Useful for diffing against `shippingAmount`.",
109580
+ "args": [],
109581
+ "type": {
109582
+ "kind": "SCALAR",
109583
+ "name": "Float",
109584
+ "ofType": null
109585
+ },
109586
+ "isDeprecated": false,
109587
+ "deprecationReason": null
109588
+ },
109589
+ {
109590
+ "name": "shippingAmountPreserved",
109591
+ "description": "Whether the shipping amount was preserved (keepShippingAmount flag).",
108785
109592
  "args": [],
108786
109593
  "type": {
108787
109594
  "kind": "NON_NULL",
@@ -108794,22 +109601,68 @@
108794
109601
  },
108795
109602
  "isDeprecated": false,
108796
109603
  "deprecationReason": null
109604
+ }
109605
+ ],
109606
+ "inputFields": null,
109607
+ "interfaces": [],
109608
+ "enumValues": null,
109609
+ "possibleTypes": null
109610
+ },
109611
+ {
109612
+ "kind": "ENUM",
109613
+ "name": "ShippingProviderPickupType",
109614
+ "description": "Type of pickup selection a shipping provider needs.",
109615
+ "fields": null,
109616
+ "inputFields": null,
109617
+ "interfaces": null,
109618
+ "enumValues": [
109619
+ {
109620
+ "name": "ADDRESS",
109621
+ "description": "Delivery to the customer's street address — no pickup needed.",
109622
+ "isDeprecated": false,
109623
+ "deprecationReason": null
108797
109624
  },
108798
109625
  {
108799
- "name": "address",
108800
- "description": "Shop address.",
109626
+ "name": "OFFICE",
109627
+ "description": "Delivery to one of the provider's physical offices.",
109628
+ "isDeprecated": false,
109629
+ "deprecationReason": null
109630
+ },
109631
+ {
109632
+ "name": "LOCKER",
109633
+ "description": "Delivery to a parcel locker / automatic terminal.",
109634
+ "isDeprecated": false,
109635
+ "deprecationReason": null
109636
+ },
109637
+ {
109638
+ "name": "MARKETPLACE",
109639
+ "description": "Delivery to a partner marketplace pickup point.",
109640
+ "isDeprecated": false,
109641
+ "deprecationReason": null
109642
+ }
109643
+ ],
109644
+ "possibleTypes": null
109645
+ },
109646
+ {
109647
+ "kind": "OBJECT",
109648
+ "name": "ShippingCountry",
109649
+ "description": "A country supported by a shipping provider. Populated by the provider's `listCountries()` — what each carrier actually services.",
109650
+ "fields": [
109651
+ {
109652
+ "name": "id",
109653
+ "description": "Country ID (provider-specific, usually matches the local cities database).",
108801
109654
  "args": [],
108802
109655
  "type": {
108803
109656
  "kind": "SCALAR",
108804
- "name": "JSON",
109657
+ "name": "String",
108805
109658
  "ofType": null
108806
109659
  },
108807
109660
  "isDeprecated": false,
108808
109661
  "deprecationReason": null
108809
109662
  },
108810
109663
  {
108811
- "name": "urlHandle",
108812
- "description": "Shop URL handle.",
109664
+ "name": "iso2",
109665
+ "description": "ISO 3166-1 alpha-2 country code (e.g. BG, RO, GR).",
108813
109666
  "args": [],
108814
109667
  "type": {
108815
109668
  "kind": "SCALAR",
@@ -108820,44 +109673,36 @@
108820
109673
  "deprecationReason": null
108821
109674
  },
108822
109675
  {
108823
- "name": "worktime",
108824
- "description": "Working hours configuration.",
109676
+ "name": "iso3",
109677
+ "description": "ISO 3166-1 alpha-3 country code (e.g. BGR, ROU, GRC).",
108825
109678
  "args": [],
108826
109679
  "type": {
108827
- "kind": "LIST",
108828
- "name": null,
108829
- "ofType": {
108830
- "kind": "NON_NULL",
108831
- "name": null,
108832
- "ofType": {
108833
- "kind": "OBJECT",
108834
- "name": "GlovoWorktime",
108835
- "ofType": null
108836
- }
108837
- }
109680
+ "kind": "SCALAR",
109681
+ "name": "String",
109682
+ "ofType": null
108838
109683
  },
108839
109684
  "isDeprecated": false,
108840
109685
  "deprecationReason": null
108841
109686
  },
108842
109687
  {
108843
- "name": "priceLists",
108844
- "description": "Price lists for distance-based delivery.",
109688
+ "name": "name",
109689
+ "description": "Localised country name (language follows the current admin locale).",
108845
109690
  "args": [],
108846
109691
  "type": {
108847
109692
  "kind": "SCALAR",
108848
- "name": "JSON",
109693
+ "name": "String",
108849
109694
  "ofType": null
108850
109695
  },
108851
109696
  "isDeprecated": false,
108852
109697
  "deprecationReason": null
108853
109698
  },
108854
109699
  {
108855
- "name": "keys",
108856
- "description": "API keys (public/private).",
109700
+ "name": "phoneCode",
109701
+ "description": "Phone/calling code (e.g. 359 for Bulgaria), when the provider exposes it.",
108857
109702
  "args": [],
108858
109703
  "type": {
108859
109704
  "kind": "SCALAR",
108860
- "name": "JSON",
109705
+ "name": "String",
108861
109706
  "ofType": null
108862
109707
  },
108863
109708
  "isDeprecated": false,
@@ -108871,19 +109716,19 @@
108871
109716
  },
108872
109717
  {
108873
109718
  "kind": "OBJECT",
108874
- "name": "GlovoWorktime",
108875
- "description": "Glovo shop working hours for a specific day.",
109719
+ "name": "ShippingPdfFormat",
109720
+ "description": "A PDF output format supported by a shipping provider for waybill printing.",
108876
109721
  "fields": [
108877
109722
  {
108878
- "name": "day",
108879
- "description": "Day of week (1=Monday, 7=Sunday).",
109723
+ "name": "type",
109724
+ "description": "Machine identifier to pass as `type` to `getShippingWaybillPdf` (e.g. `A4`, `A6`, `label`, `printer`, `sticker`).",
108880
109725
  "args": [],
108881
109726
  "type": {
108882
109727
  "kind": "NON_NULL",
108883
109728
  "name": null,
108884
109729
  "ofType": {
108885
109730
  "kind": "SCALAR",
108886
- "name": "Int",
109731
+ "name": "String",
108887
109732
  "ofType": null
108888
109733
  }
108889
109734
  },
@@ -108891,20 +109736,8 @@
108891
109736
  "deprecationReason": null
108892
109737
  },
108893
109738
  {
108894
- "name": "from",
108895
- "description": "Opening time (HH:MM).",
108896
- "args": [],
108897
- "type": {
108898
- "kind": "SCALAR",
108899
- "name": "String",
108900
- "ofType": null
108901
- },
108902
- "isDeprecated": false,
108903
- "deprecationReason": null
108904
- },
108905
- {
108906
- "name": "to",
108907
- "description": "Closing time (HH:MM).",
109739
+ "name": "label",
109740
+ "description": "Human-readable label describing the format.",
108908
109741
  "args": [],
108909
109742
  "type": {
108910
109743
  "kind": "SCALAR",
@@ -108913,22 +109746,6 @@
108913
109746
  },
108914
109747
  "isDeprecated": false,
108915
109748
  "deprecationReason": null
108916
- },
108917
- {
108918
- "name": "isActive",
108919
- "description": "Whether the shop is active on this day.",
108920
- "args": [],
108921
- "type": {
108922
- "kind": "NON_NULL",
108923
- "name": null,
108924
- "ofType": {
108925
- "kind": "SCALAR",
108926
- "name": "Boolean",
108927
- "ofType": null
108928
- }
108929
- },
108930
- "isDeprecated": false,
108931
- "deprecationReason": null
108932
109749
  }
108933
109750
  ],
108934
109751
  "inputFields": null,
@@ -108938,8 +109755,8 @@
108938
109755
  },
108939
109756
  {
108940
109757
  "kind": "OBJECT",
108941
- "name": "GlovoShopConfig",
108942
- "description": "Glovo shop configuration with API keys.",
109758
+ "name": "GlovoShop",
109759
+ "description": "A Glovo store/shop location.",
108943
109760
  "fields": [
108944
109761
  {
108945
109762
  "name": "id",
@@ -108958,8 +109775,8 @@
108958
109775
  "deprecationReason": null
108959
109776
  },
108960
109777
  {
108961
- "name": "publicKey",
108962
- "description": "Public API key.",
109778
+ "name": "title",
109779
+ "description": "Shop title.",
108963
109780
  "args": [],
108964
109781
  "type": {
108965
109782
  "kind": "SCALAR",
@@ -108970,8 +109787,8 @@
108970
109787
  "deprecationReason": null
108971
109788
  },
108972
109789
  {
108973
- "name": "privateKey",
108974
- "description": "Private API key.",
109790
+ "name": "email",
109791
+ "description": "Shop email.",
108975
109792
  "args": [],
108976
109793
  "type": {
108977
109794
  "kind": "SCALAR",
@@ -108980,44 +109797,29 @@
108980
109797
  },
108981
109798
  "isDeprecated": false,
108982
109799
  "deprecationReason": null
108983
- }
108984
- ],
108985
- "inputFields": null,
108986
- "interfaces": [],
108987
- "enumValues": null,
108988
- "possibleTypes": null
108989
- },
108990
- {
108991
- "kind": "OBJECT",
108992
- "name": "SendcloudCourier",
108993
- "description": "A SendCloud courier/carrier.",
108994
- "fields": [
109800
+ },
108995
109801
  {
108996
- "name": "id",
108997
- "description": "Courier ID.",
109802
+ "name": "phone",
109803
+ "description": "Shop phone number.",
108998
109804
  "args": [],
108999
109805
  "type": {
109000
- "kind": "NON_NULL",
109001
- "name": null,
109002
- "ofType": {
109003
- "kind": "SCALAR",
109004
- "name": "ID",
109005
- "ofType": null
109006
- }
109806
+ "kind": "SCALAR",
109807
+ "name": "String",
109808
+ "ofType": null
109007
109809
  },
109008
109810
  "isDeprecated": false,
109009
109811
  "deprecationReason": null
109010
109812
  },
109011
109813
  {
109012
- "name": "name",
109013
- "description": "Courier name.",
109814
+ "name": "active",
109815
+ "description": "Whether the shop is active.",
109014
109816
  "args": [],
109015
109817
  "type": {
109016
109818
  "kind": "NON_NULL",
109017
109819
  "name": null,
109018
109820
  "ofType": {
109019
109821
  "kind": "SCALAR",
109020
- "name": "String",
109822
+ "name": "Boolean",
109021
109823
  "ofType": null
109022
109824
  }
109023
109825
  },
@@ -109025,8 +109827,20 @@
109025
109827
  "deprecationReason": null
109026
109828
  },
109027
109829
  {
109028
- "name": "logo",
109029
- "description": "Courier logo URL.",
109830
+ "name": "address",
109831
+ "description": "Shop address.",
109832
+ "args": [],
109833
+ "type": {
109834
+ "kind": "SCALAR",
109835
+ "name": "JSON",
109836
+ "ofType": null
109837
+ },
109838
+ "isDeprecated": false,
109839
+ "deprecationReason": null
109840
+ },
109841
+ {
109842
+ "name": "urlHandle",
109843
+ "description": "Shop URL handle.",
109030
109844
  "args": [],
109031
109845
  "type": {
109032
109846
  "kind": "SCALAR",
@@ -109037,36 +109851,40 @@
109037
109851
  "deprecationReason": null
109038
109852
  },
109039
109853
  {
109040
- "name": "isInstalled",
109041
- "description": "Whether this courier is installed.",
109854
+ "name": "worktime",
109855
+ "description": "Working hours configuration.",
109042
109856
  "args": [],
109043
109857
  "type": {
109044
- "kind": "NON_NULL",
109858
+ "kind": "LIST",
109045
109859
  "name": null,
109046
109860
  "ofType": {
109047
- "kind": "SCALAR",
109048
- "name": "Boolean",
109049
- "ofType": null
109861
+ "kind": "NON_NULL",
109862
+ "name": null,
109863
+ "ofType": {
109864
+ "kind": "OBJECT",
109865
+ "name": "GlovoWorktime",
109866
+ "ofType": null
109867
+ }
109050
109868
  }
109051
109869
  },
109052
109870
  "isDeprecated": false,
109053
109871
  "deprecationReason": null
109054
109872
  },
109055
109873
  {
109056
- "name": "externalId",
109057
- "description": "External ID if installed.",
109874
+ "name": "priceLists",
109875
+ "description": "Price lists for distance-based delivery.",
109058
109876
  "args": [],
109059
109877
  "type": {
109060
109878
  "kind": "SCALAR",
109061
- "name": "String",
109879
+ "name": "JSON",
109062
109880
  "ofType": null
109063
109881
  },
109064
109882
  "isDeprecated": false,
109065
109883
  "deprecationReason": null
109066
109884
  },
109067
109885
  {
109068
- "name": "data",
109069
- "description": "Courier-specific data.",
109886
+ "name": "keys",
109887
+ "description": "API keys (public/private).",
109070
109888
  "args": [],
109071
109889
  "type": {
109072
109890
  "kind": "SCALAR",
@@ -109084,19 +109902,19 @@
109084
109902
  },
109085
109903
  {
109086
109904
  "kind": "OBJECT",
109087
- "name": "SendcloudSenderAddress",
109088
- "description": "A SendCloud sender address.",
109905
+ "name": "GlovoWorktime",
109906
+ "description": "Glovo shop working hours for a specific day.",
109089
109907
  "fields": [
109090
109908
  {
109091
- "name": "id",
109092
- "description": "Address ID.",
109909
+ "name": "day",
109910
+ "description": "Day of week (1=Monday, 7=Sunday).",
109093
109911
  "args": [],
109094
109912
  "type": {
109095
109913
  "kind": "NON_NULL",
109096
109914
  "name": null,
109097
109915
  "ofType": {
109098
109916
  "kind": "SCALAR",
109099
- "name": "ID",
109917
+ "name": "Int",
109100
109918
  "ofType": null
109101
109919
  }
109102
109920
  },
@@ -109104,8 +109922,8 @@
109104
109922
  "deprecationReason": null
109105
109923
  },
109106
109924
  {
109107
- "name": "company",
109108
- "description": "Company name.",
109925
+ "name": "from",
109926
+ "description": "Opening time (HH:MM).",
109109
109927
  "args": [],
109110
109928
  "type": {
109111
109929
  "kind": "SCALAR",
@@ -109116,8 +109934,8 @@
109116
109934
  "deprecationReason": null
109117
109935
  },
109118
109936
  {
109119
- "name": "street",
109120
- "description": "Street address.",
109937
+ "name": "to",
109938
+ "description": "Closing time (HH:MM).",
109121
109939
  "args": [],
109122
109940
  "type": {
109123
109941
  "kind": "SCALAR",
@@ -109128,20 +109946,51 @@
109128
109946
  "deprecationReason": null
109129
109947
  },
109130
109948
  {
109131
- "name": "city",
109132
- "description": "City.",
109949
+ "name": "isActive",
109950
+ "description": "Whether the shop is active on this day.",
109133
109951
  "args": [],
109134
109952
  "type": {
109135
- "kind": "SCALAR",
109136
- "name": "String",
109137
- "ofType": null
109953
+ "kind": "NON_NULL",
109954
+ "name": null,
109955
+ "ofType": {
109956
+ "kind": "SCALAR",
109957
+ "name": "Boolean",
109958
+ "ofType": null
109959
+ }
109960
+ },
109961
+ "isDeprecated": false,
109962
+ "deprecationReason": null
109963
+ }
109964
+ ],
109965
+ "inputFields": null,
109966
+ "interfaces": [],
109967
+ "enumValues": null,
109968
+ "possibleTypes": null
109969
+ },
109970
+ {
109971
+ "kind": "OBJECT",
109972
+ "name": "GlovoShopConfig",
109973
+ "description": "Glovo shop configuration with API keys.",
109974
+ "fields": [
109975
+ {
109976
+ "name": "id",
109977
+ "description": "Shop ID.",
109978
+ "args": [],
109979
+ "type": {
109980
+ "kind": "NON_NULL",
109981
+ "name": null,
109982
+ "ofType": {
109983
+ "kind": "SCALAR",
109984
+ "name": "ID",
109985
+ "ofType": null
109986
+ }
109138
109987
  },
109139
109988
  "isDeprecated": false,
109140
109989
  "deprecationReason": null
109141
109990
  },
109142
109991
  {
109143
- "name": "postalCode",
109144
- "description": "Postal code.",
109992
+ "name": "publicKey",
109993
+ "description": "Public API key.",
109145
109994
  "args": [],
109146
109995
  "type": {
109147
109996
  "kind": "SCALAR",
@@ -109152,8 +110001,8 @@
109152
110001
  "deprecationReason": null
109153
110002
  },
109154
110003
  {
109155
- "name": "country",
109156
- "description": "Country.",
110004
+ "name": "privateKey",
110005
+ "description": "Private API key.",
109157
110006
  "args": [],
109158
110007
  "type": {
109159
110008
  "kind": "SCALAR",
@@ -109171,8 +110020,190 @@
109171
110020
  },
109172
110021
  {
109173
110022
  "kind": "OBJECT",
109174
- "name": "EushipmentCourier",
109175
- "description": "An euShipment courier/carrier.",
110023
+ "name": "SendcloudCourier",
110024
+ "description": "A SendCloud courier/carrier.",
110025
+ "fields": [
110026
+ {
110027
+ "name": "id",
110028
+ "description": "Courier ID.",
110029
+ "args": [],
110030
+ "type": {
110031
+ "kind": "NON_NULL",
110032
+ "name": null,
110033
+ "ofType": {
110034
+ "kind": "SCALAR",
110035
+ "name": "ID",
110036
+ "ofType": null
110037
+ }
110038
+ },
110039
+ "isDeprecated": false,
110040
+ "deprecationReason": null
110041
+ },
110042
+ {
110043
+ "name": "name",
110044
+ "description": "Courier name.",
110045
+ "args": [],
110046
+ "type": {
110047
+ "kind": "NON_NULL",
110048
+ "name": null,
110049
+ "ofType": {
110050
+ "kind": "SCALAR",
110051
+ "name": "String",
110052
+ "ofType": null
110053
+ }
110054
+ },
110055
+ "isDeprecated": false,
110056
+ "deprecationReason": null
110057
+ },
110058
+ {
110059
+ "name": "logo",
110060
+ "description": "Courier logo URL.",
110061
+ "args": [],
110062
+ "type": {
110063
+ "kind": "SCALAR",
110064
+ "name": "String",
110065
+ "ofType": null
110066
+ },
110067
+ "isDeprecated": false,
110068
+ "deprecationReason": null
110069
+ },
110070
+ {
110071
+ "name": "isInstalled",
110072
+ "description": "Whether this courier is installed.",
110073
+ "args": [],
110074
+ "type": {
110075
+ "kind": "NON_NULL",
110076
+ "name": null,
110077
+ "ofType": {
110078
+ "kind": "SCALAR",
110079
+ "name": "Boolean",
110080
+ "ofType": null
110081
+ }
110082
+ },
110083
+ "isDeprecated": false,
110084
+ "deprecationReason": null
110085
+ },
110086
+ {
110087
+ "name": "externalId",
110088
+ "description": "External ID if installed.",
110089
+ "args": [],
110090
+ "type": {
110091
+ "kind": "SCALAR",
110092
+ "name": "String",
110093
+ "ofType": null
110094
+ },
110095
+ "isDeprecated": false,
110096
+ "deprecationReason": null
110097
+ },
110098
+ {
110099
+ "name": "data",
110100
+ "description": "Courier-specific data.",
110101
+ "args": [],
110102
+ "type": {
110103
+ "kind": "SCALAR",
110104
+ "name": "JSON",
110105
+ "ofType": null
110106
+ },
110107
+ "isDeprecated": false,
110108
+ "deprecationReason": null
110109
+ }
110110
+ ],
110111
+ "inputFields": null,
110112
+ "interfaces": [],
110113
+ "enumValues": null,
110114
+ "possibleTypes": null
110115
+ },
110116
+ {
110117
+ "kind": "OBJECT",
110118
+ "name": "SendcloudSenderAddress",
110119
+ "description": "A SendCloud sender address.",
110120
+ "fields": [
110121
+ {
110122
+ "name": "id",
110123
+ "description": "Address ID.",
110124
+ "args": [],
110125
+ "type": {
110126
+ "kind": "NON_NULL",
110127
+ "name": null,
110128
+ "ofType": {
110129
+ "kind": "SCALAR",
110130
+ "name": "ID",
110131
+ "ofType": null
110132
+ }
110133
+ },
110134
+ "isDeprecated": false,
110135
+ "deprecationReason": null
110136
+ },
110137
+ {
110138
+ "name": "company",
110139
+ "description": "Company name.",
110140
+ "args": [],
110141
+ "type": {
110142
+ "kind": "SCALAR",
110143
+ "name": "String",
110144
+ "ofType": null
110145
+ },
110146
+ "isDeprecated": false,
110147
+ "deprecationReason": null
110148
+ },
110149
+ {
110150
+ "name": "street",
110151
+ "description": "Street address.",
110152
+ "args": [],
110153
+ "type": {
110154
+ "kind": "SCALAR",
110155
+ "name": "String",
110156
+ "ofType": null
110157
+ },
110158
+ "isDeprecated": false,
110159
+ "deprecationReason": null
110160
+ },
110161
+ {
110162
+ "name": "city",
110163
+ "description": "City.",
110164
+ "args": [],
110165
+ "type": {
110166
+ "kind": "SCALAR",
110167
+ "name": "String",
110168
+ "ofType": null
110169
+ },
110170
+ "isDeprecated": false,
110171
+ "deprecationReason": null
110172
+ },
110173
+ {
110174
+ "name": "postalCode",
110175
+ "description": "Postal code.",
110176
+ "args": [],
110177
+ "type": {
110178
+ "kind": "SCALAR",
110179
+ "name": "String",
110180
+ "ofType": null
110181
+ },
110182
+ "isDeprecated": false,
110183
+ "deprecationReason": null
110184
+ },
110185
+ {
110186
+ "name": "country",
110187
+ "description": "Country.",
110188
+ "args": [],
110189
+ "type": {
110190
+ "kind": "SCALAR",
110191
+ "name": "String",
110192
+ "ofType": null
110193
+ },
110194
+ "isDeprecated": false,
110195
+ "deprecationReason": null
110196
+ }
110197
+ ],
110198
+ "inputFields": null,
110199
+ "interfaces": [],
110200
+ "enumValues": null,
110201
+ "possibleTypes": null
110202
+ },
110203
+ {
110204
+ "kind": "OBJECT",
110205
+ "name": "EushipmentCourier",
110206
+ "description": "An euShipment courier/carrier.",
109176
110207
  "fields": [
109177
110208
  {
109178
110209
  "name": "id",
@@ -109892,6 +110923,16 @@
109892
110923
  "ofType": null
109893
110924
  },
109894
110925
  "defaultValue": null
110926
+ },
110927
+ {
110928
+ "name": "provider_options",
110929
+ "description": "Provider-specific options as a JSON object. Keys are the provider's own waybill-request field names (e.g. for Econt: priority_time, priority_type, priority_hour, pay_after_accept, back_documents, instruction). Call shippingWaybillSchema(key: <provider>) first to discover the supported keys, their types, required-if dependencies and mutually-exclusive pairs.",
110930
+ "type": {
110931
+ "kind": "SCALAR",
110932
+ "name": "JSON",
110933
+ "ofType": null
110934
+ },
110935
+ "defaultValue": null
109895
110936
  }
109896
110937
  ],
109897
110938
  "interfaces": null,
@@ -110169,7 +111210,7 @@
110169
111210
  "inputFields": [
110170
111211
  {
110171
111212
  "name": "query",
110172
- "description": "Search query.",
111213
+ "description": "Search query (office name fragment).",
110173
111214
  "type": {
110174
111215
  "kind": "SCALAR",
110175
111216
  "name": "String",
@@ -110179,7 +111220,7 @@
110179
111220
  },
110180
111221
  {
110181
111222
  "name": "city",
110182
- "description": "Filter by city.",
111223
+ "description": "Filter by city name (plain text).",
110183
111224
  "type": {
110184
111225
  "kind": "SCALAR",
110185
111226
  "name": "String",
@@ -110189,7 +111230,7 @@
110189
111230
  },
110190
111231
  {
110191
111232
  "name": "city_id",
110192
- "description": "Filter by city ID.",
111233
+ "description": "Filter by city ID (from the provider's city catalogue). Takes precedence over when both are supplied.",
110193
111234
  "type": {
110194
111235
  "kind": "SCALAR",
110195
111236
  "name": "String",
@@ -110199,7 +111240,7 @@
110199
111240
  },
110200
111241
  {
110201
111242
  "name": "type",
110202
- "description": "Filter by type (office, locker, etc.).",
111243
+ "description": "Filter by office type (e.g. office, locker, apt).",
110203
111244
  "type": {
110204
111245
  "kind": "SCALAR",
110205
111246
  "name": "String",
@@ -110216,6 +111257,26 @@
110216
111257
  "ofType": null
110217
111258
  },
110218
111259
  "defaultValue": null
111260
+ },
111261
+ {
111262
+ "name": "country",
111263
+ "description": "Filter by country ISO2 code (e.g. BG, RO, GR). Post-filters the office list against each office's country.",
111264
+ "type": {
111265
+ "kind": "SCALAR",
111266
+ "name": "String",
111267
+ "ofType": null
111268
+ },
111269
+ "defaultValue": null
111270
+ },
111271
+ {
111272
+ "name": "limit",
111273
+ "description": "Max results to return (safety cap). Defaults to 200.",
111274
+ "type": {
111275
+ "kind": "SCALAR",
111276
+ "name": "Int",
111277
+ "ofType": null
111278
+ },
111279
+ "defaultValue": null
110219
111280
  }
110220
111281
  ],
110221
111282
  "interfaces": null,
@@ -110488,6 +111549,576 @@
110488
111549
  "enumValues": null,
110489
111550
  "possibleTypes": null
110490
111551
  },
111552
+ {
111553
+ "kind": "OBJECT",
111554
+ "name": "ShippingWaybillFieldDescriptor",
111555
+ "description": "Describes a single field on the waybill-creation input for a specific shipping provider.",
111556
+ "fields": [
111557
+ {
111558
+ "name": "name",
111559
+ "description": "Machine name of the field (camelCase, e.g. 'priorityType').",
111560
+ "args": [],
111561
+ "type": {
111562
+ "kind": "NON_NULL",
111563
+ "name": null,
111564
+ "ofType": {
111565
+ "kind": "SCALAR",
111566
+ "name": "String",
111567
+ "ofType": null
111568
+ }
111569
+ },
111570
+ "isDeprecated": false,
111571
+ "deprecationReason": null
111572
+ },
111573
+ {
111574
+ "name": "path",
111575
+ "description": "Dot-path of the field inside the request payload (e.g. 'waybill.priority_type'). Use this when mapping into `providerOptions` JSON.",
111576
+ "args": [],
111577
+ "type": {
111578
+ "kind": "NON_NULL",
111579
+ "name": null,
111580
+ "ofType": {
111581
+ "kind": "SCALAR",
111582
+ "name": "String",
111583
+ "ofType": null
111584
+ }
111585
+ },
111586
+ "isDeprecated": false,
111587
+ "deprecationReason": null
111588
+ },
111589
+ {
111590
+ "name": "label",
111591
+ "description": "Human-readable label (translated when available).",
111592
+ "args": [],
111593
+ "type": {
111594
+ "kind": "SCALAR",
111595
+ "name": "String",
111596
+ "ofType": null
111597
+ },
111598
+ "isDeprecated": false,
111599
+ "deprecationReason": null
111600
+ },
111601
+ {
111602
+ "name": "type",
111603
+ "description": "Data type of the field.",
111604
+ "args": [],
111605
+ "type": {
111606
+ "kind": "NON_NULL",
111607
+ "name": null,
111608
+ "ofType": {
111609
+ "kind": "ENUM",
111610
+ "name": "ShippingFieldType",
111611
+ "ofType": null
111612
+ }
111613
+ },
111614
+ "isDeprecated": false,
111615
+ "deprecationReason": null
111616
+ },
111617
+ {
111618
+ "name": "required",
111619
+ "description": "Whether the field is always required.",
111620
+ "args": [],
111621
+ "type": {
111622
+ "kind": "NON_NULL",
111623
+ "name": null,
111624
+ "ofType": {
111625
+ "kind": "SCALAR",
111626
+ "name": "Boolean",
111627
+ "ofType": null
111628
+ }
111629
+ },
111630
+ "isDeprecated": false,
111631
+ "deprecationReason": null
111632
+ },
111633
+ {
111634
+ "name": "requiredIf",
111635
+ "description": "Conditional-requirement expression derived from `required_if` / `required_with` rules, e.g. 'waybill.cod=1'.",
111636
+ "args": [],
111637
+ "type": {
111638
+ "kind": "SCALAR",
111639
+ "name": "String",
111640
+ "ofType": null
111641
+ },
111642
+ "isDeprecated": false,
111643
+ "deprecationReason": null
111644
+ },
111645
+ {
111646
+ "name": "description",
111647
+ "description": "Human-readable description explaining the purpose of the field (from lang/messages).",
111648
+ "args": [],
111649
+ "type": {
111650
+ "kind": "SCALAR",
111651
+ "name": "String",
111652
+ "ofType": null
111653
+ },
111654
+ "isDeprecated": false,
111655
+ "deprecationReason": null
111656
+ },
111657
+ {
111658
+ "name": "enumValues",
111659
+ "description": "For ENUM types: the list of allowed raw values.",
111660
+ "args": [],
111661
+ "type": {
111662
+ "kind": "LIST",
111663
+ "name": null,
111664
+ "ofType": {
111665
+ "kind": "NON_NULL",
111666
+ "name": null,
111667
+ "ofType": {
111668
+ "kind": "SCALAR",
111669
+ "name": "String",
111670
+ "ofType": null
111671
+ }
111672
+ }
111673
+ },
111674
+ "isDeprecated": false,
111675
+ "deprecationReason": null
111676
+ },
111677
+ {
111678
+ "name": "enumLabels",
111679
+ "description": "For ENUM types: optional human-readable labels, positionally aligned with `enumValues`.",
111680
+ "args": [],
111681
+ "type": {
111682
+ "kind": "LIST",
111683
+ "name": null,
111684
+ "ofType": {
111685
+ "kind": "NON_NULL",
111686
+ "name": null,
111687
+ "ofType": {
111688
+ "kind": "SCALAR",
111689
+ "name": "String",
111690
+ "ofType": null
111691
+ }
111692
+ }
111693
+ },
111694
+ "isDeprecated": false,
111695
+ "deprecationReason": null
111696
+ },
111697
+ {
111698
+ "name": "min",
111699
+ "description": "For NUMBER/INTEGER types: minimum value (inclusive).",
111700
+ "args": [],
111701
+ "type": {
111702
+ "kind": "SCALAR",
111703
+ "name": "Float",
111704
+ "ofType": null
111705
+ },
111706
+ "isDeprecated": false,
111707
+ "deprecationReason": null
111708
+ },
111709
+ {
111710
+ "name": "max",
111711
+ "description": "For NUMBER/INTEGER types: maximum value (inclusive).",
111712
+ "args": [],
111713
+ "type": {
111714
+ "kind": "SCALAR",
111715
+ "name": "Float",
111716
+ "ofType": null
111717
+ },
111718
+ "isDeprecated": false,
111719
+ "deprecationReason": null
111720
+ },
111721
+ {
111722
+ "name": "minLength",
111723
+ "description": "For STRING types: minimum length.",
111724
+ "args": [],
111725
+ "type": {
111726
+ "kind": "SCALAR",
111727
+ "name": "Int",
111728
+ "ofType": null
111729
+ },
111730
+ "isDeprecated": false,
111731
+ "deprecationReason": null
111732
+ },
111733
+ {
111734
+ "name": "maxLength",
111735
+ "description": "For STRING types: maximum length.",
111736
+ "args": [],
111737
+ "type": {
111738
+ "kind": "SCALAR",
111739
+ "name": "Int",
111740
+ "ofType": null
111741
+ },
111742
+ "isDeprecated": false,
111743
+ "deprecationReason": null
111744
+ },
111745
+ {
111746
+ "name": "mutuallyExclusiveWith",
111747
+ "description": "Other field paths that cannot be set simultaneously with this one (e.g. 'dc' and 'back_documents' in Econt).",
111748
+ "args": [],
111749
+ "type": {
111750
+ "kind": "LIST",
111751
+ "name": null,
111752
+ "ofType": {
111753
+ "kind": "NON_NULL",
111754
+ "name": null,
111755
+ "ofType": {
111756
+ "kind": "SCALAR",
111757
+ "name": "String",
111758
+ "ofType": null
111759
+ }
111760
+ }
111761
+ },
111762
+ "isDeprecated": false,
111763
+ "deprecationReason": null
111764
+ },
111765
+ {
111766
+ "name": "dependentFields",
111767
+ "description": "Other field paths that become required or relevant when this field is set.",
111768
+ "args": [],
111769
+ "type": {
111770
+ "kind": "LIST",
111771
+ "name": null,
111772
+ "ofType": {
111773
+ "kind": "NON_NULL",
111774
+ "name": null,
111775
+ "ofType": {
111776
+ "kind": "SCALAR",
111777
+ "name": "String",
111778
+ "ofType": null
111779
+ }
111780
+ }
111781
+ },
111782
+ "isDeprecated": false,
111783
+ "deprecationReason": null
111784
+ },
111785
+ {
111786
+ "name": "itemFields",
111787
+ "description": "For ARRAY types: schema of a single element.",
111788
+ "args": [],
111789
+ "type": {
111790
+ "kind": "LIST",
111791
+ "name": null,
111792
+ "ofType": {
111793
+ "kind": "NON_NULL",
111794
+ "name": null,
111795
+ "ofType": {
111796
+ "kind": "OBJECT",
111797
+ "name": "ShippingWaybillFieldDescriptor",
111798
+ "ofType": null
111799
+ }
111800
+ }
111801
+ },
111802
+ "isDeprecated": false,
111803
+ "deprecationReason": null
111804
+ },
111805
+ {
111806
+ "name": "example",
111807
+ "description": "Example value as a JSON-encoded string (e.g. '\"BEFORE\"', '14', '[{\"name\":\"box\",\"weight\":1}]').",
111808
+ "args": [],
111809
+ "type": {
111810
+ "kind": "SCALAR",
111811
+ "name": "String",
111812
+ "ofType": null
111813
+ },
111814
+ "isDeprecated": false,
111815
+ "deprecationReason": null
111816
+ },
111817
+ {
111818
+ "name": "default",
111819
+ "description": "Default value as a JSON-encoded string (if a default is known).",
111820
+ "args": [],
111821
+ "type": {
111822
+ "kind": "SCALAR",
111823
+ "name": "String",
111824
+ "ofType": null
111825
+ },
111826
+ "isDeprecated": false,
111827
+ "deprecationReason": null
111828
+ }
111829
+ ],
111830
+ "inputFields": null,
111831
+ "interfaces": [],
111832
+ "enumValues": null,
111833
+ "possibleTypes": null
111834
+ },
111835
+ {
111836
+ "kind": "ENUM",
111837
+ "name": "ShippingFieldType",
111838
+ "description": "High-level data type of a waybill field.",
111839
+ "fields": null,
111840
+ "inputFields": null,
111841
+ "interfaces": null,
111842
+ "enumValues": [
111843
+ {
111844
+ "name": "STRING",
111845
+ "description": "Plain string value.",
111846
+ "isDeprecated": false,
111847
+ "deprecationReason": null
111848
+ },
111849
+ {
111850
+ "name": "NUMBER",
111851
+ "description": "Floating-point number.",
111852
+ "isDeprecated": false,
111853
+ "deprecationReason": null
111854
+ },
111855
+ {
111856
+ "name": "INTEGER",
111857
+ "description": "Whole number.",
111858
+ "isDeprecated": false,
111859
+ "deprecationReason": null
111860
+ },
111861
+ {
111862
+ "name": "BOOLEAN",
111863
+ "description": "True/false.",
111864
+ "isDeprecated": false,
111865
+ "deprecationReason": null
111866
+ },
111867
+ {
111868
+ "name": "ENUM",
111869
+ "description": "One of a fixed set of string values.",
111870
+ "isDeprecated": false,
111871
+ "deprecationReason": null
111872
+ },
111873
+ {
111874
+ "name": "DATE",
111875
+ "description": "Date or datetime value.",
111876
+ "isDeprecated": false,
111877
+ "deprecationReason": null
111878
+ },
111879
+ {
111880
+ "name": "ARRAY",
111881
+ "description": "An array of sub-objects (see itemFields for the element schema).",
111882
+ "isDeprecated": false,
111883
+ "deprecationReason": null
111884
+ },
111885
+ {
111886
+ "name": "OBJECT",
111887
+ "description": "A nested object (see itemFields for its fields).",
111888
+ "isDeprecated": false,
111889
+ "deprecationReason": null
111890
+ },
111891
+ {
111892
+ "name": "JSON",
111893
+ "description": "Free-form JSON — the structure is not statically described.",
111894
+ "isDeprecated": false,
111895
+ "deprecationReason": null
111896
+ }
111897
+ ],
111898
+ "possibleTypes": null
111899
+ },
111900
+ {
111901
+ "kind": "OBJECT",
111902
+ "name": "ShippingServiceOption",
111903
+ "description": "Service option offered by a shipping provider for a given order (e.g. office-to-office, to-address).",
111904
+ "fields": [
111905
+ {
111906
+ "name": "id",
111907
+ "description": "Machine identifier of the service as used by the provider API.",
111908
+ "args": [],
111909
+ "type": {
111910
+ "kind": "NON_NULL",
111911
+ "name": null,
111912
+ "ofType": {
111913
+ "kind": "SCALAR",
111914
+ "name": "String",
111915
+ "ofType": null
111916
+ }
111917
+ },
111918
+ "isDeprecated": false,
111919
+ "deprecationReason": null
111920
+ },
111921
+ {
111922
+ "name": "name",
111923
+ "description": "Human-readable name of the service.",
111924
+ "args": [],
111925
+ "type": {
111926
+ "kind": "SCALAR",
111927
+ "name": "String",
111928
+ "ofType": null
111929
+ },
111930
+ "isDeprecated": false,
111931
+ "deprecationReason": null
111932
+ },
111933
+ {
111934
+ "name": "deliveryDeadline",
111935
+ "description": "Optional delivery deadline label.",
111936
+ "args": [],
111937
+ "type": {
111938
+ "kind": "SCALAR",
111939
+ "name": "String",
111940
+ "ofType": null
111941
+ },
111942
+ "isDeprecated": false,
111943
+ "deprecationReason": null
111944
+ },
111945
+ {
111946
+ "name": "pickupDate",
111947
+ "description": "Optional pickup date label.",
111948
+ "args": [],
111949
+ "type": {
111950
+ "kind": "SCALAR",
111951
+ "name": "String",
111952
+ "ofType": null
111953
+ },
111954
+ "isDeprecated": false,
111955
+ "deprecationReason": null
111956
+ },
111957
+ {
111958
+ "name": "price",
111959
+ "description": "Calculated price for this service in the order's currency (if available).",
111960
+ "args": [],
111961
+ "type": {
111962
+ "kind": "SCALAR",
111963
+ "name": "Float",
111964
+ "ofType": null
111965
+ },
111966
+ "isDeprecated": false,
111967
+ "deprecationReason": null
111968
+ }
111969
+ ],
111970
+ "inputFields": null,
111971
+ "interfaces": [],
111972
+ "enumValues": null,
111973
+ "possibleTypes": null
111974
+ },
111975
+ {
111976
+ "kind": "OBJECT",
111977
+ "name": "ShippingWaybillSchema",
111978
+ "description": "Complete waybill-input description for a shipping provider. Agents call this first to discover what to submit to `createShippingWaybill`.",
111979
+ "fields": [
111980
+ {
111981
+ "name": "key",
111982
+ "description": "Provider app key (e.g. 'econt', 'speedy', 'dpdbulgaria').",
111983
+ "args": [],
111984
+ "type": {
111985
+ "kind": "NON_NULL",
111986
+ "name": null,
111987
+ "ofType": {
111988
+ "kind": "SCALAR",
111989
+ "name": "String",
111990
+ "ofType": null
111991
+ }
111992
+ },
111993
+ "isDeprecated": false,
111994
+ "deprecationReason": null
111995
+ },
111996
+ {
111997
+ "name": "name",
111998
+ "description": "Provider display name.",
111999
+ "args": [],
112000
+ "type": {
112001
+ "kind": "SCALAR",
112002
+ "name": "String",
112003
+ "ofType": null
112004
+ },
112005
+ "isDeprecated": false,
112006
+ "deprecationReason": null
112007
+ },
112008
+ {
112009
+ "name": "commonFields",
112010
+ "description": "Fields that are always part of the top-level ShippingWaybillInput (service_id, weight, packages, cod, insurance, content, etc.).",
112011
+ "args": [],
112012
+ "type": {
112013
+ "kind": "NON_NULL",
112014
+ "name": null,
112015
+ "ofType": {
112016
+ "kind": "LIST",
112017
+ "name": null,
112018
+ "ofType": {
112019
+ "kind": "NON_NULL",
112020
+ "name": null,
112021
+ "ofType": {
112022
+ "kind": "OBJECT",
112023
+ "name": "ShippingWaybillFieldDescriptor",
112024
+ "ofType": null
112025
+ }
112026
+ }
112027
+ }
112028
+ },
112029
+ "isDeprecated": false,
112030
+ "deprecationReason": null
112031
+ },
112032
+ {
112033
+ "name": "providerOptions",
112034
+ "description": "Provider-specific fields expected inside `providerOptions` JSON blob.",
112035
+ "args": [],
112036
+ "type": {
112037
+ "kind": "NON_NULL",
112038
+ "name": null,
112039
+ "ofType": {
112040
+ "kind": "LIST",
112041
+ "name": null,
112042
+ "ofType": {
112043
+ "kind": "NON_NULL",
112044
+ "name": null,
112045
+ "ofType": {
112046
+ "kind": "OBJECT",
112047
+ "name": "ShippingWaybillFieldDescriptor",
112048
+ "ofType": null
112049
+ }
112050
+ }
112051
+ }
112052
+ },
112053
+ "isDeprecated": false,
112054
+ "deprecationReason": null
112055
+ },
112056
+ {
112057
+ "name": "businessRules",
112058
+ "description": "Human-readable list of business-rule guards enforced before waybill creation (e.g. order must not be archived).",
112059
+ "args": [],
112060
+ "type": {
112061
+ "kind": "NON_NULL",
112062
+ "name": null,
112063
+ "ofType": {
112064
+ "kind": "LIST",
112065
+ "name": null,
112066
+ "ofType": {
112067
+ "kind": "NON_NULL",
112068
+ "name": null,
112069
+ "ofType": {
112070
+ "kind": "SCALAR",
112071
+ "name": "String",
112072
+ "ofType": null
112073
+ }
112074
+ }
112075
+ }
112076
+ },
112077
+ "isDeprecated": false,
112078
+ "deprecationReason": null
112079
+ },
112080
+ {
112081
+ "name": "services",
112082
+ "description": "Service options available for the provided order (populated only when `orderId` is passed).",
112083
+ "args": [],
112084
+ "type": {
112085
+ "kind": "NON_NULL",
112086
+ "name": null,
112087
+ "ofType": {
112088
+ "kind": "LIST",
112089
+ "name": null,
112090
+ "ofType": {
112091
+ "kind": "NON_NULL",
112092
+ "name": null,
112093
+ "ofType": {
112094
+ "kind": "OBJECT",
112095
+ "name": "ShippingServiceOption",
112096
+ "ofType": null
112097
+ }
112098
+ }
112099
+ }
112100
+ },
112101
+ "isDeprecated": false,
112102
+ "deprecationReason": null
112103
+ },
112104
+ {
112105
+ "name": "exampleInput",
112106
+ "description": "Example complete ShippingWaybillInput as a JSON-encoded string (agents can use this as a starting template).",
112107
+ "args": [],
112108
+ "type": {
112109
+ "kind": "SCALAR",
112110
+ "name": "String",
112111
+ "ofType": null
112112
+ },
112113
+ "isDeprecated": false,
112114
+ "deprecationReason": null
112115
+ }
112116
+ ],
112117
+ "inputFields": null,
112118
+ "interfaces": [],
112119
+ "enumValues": null,
112120
+ "possibleTypes": null
112121
+ },
110491
112122
  {
110492
112123
  "kind": "OBJECT",
110493
112124
  "name": "NitroStorefront",