{"components":{"schemas":{"ApiCredentialAdminResponse":{"additionalProperties":false,"properties":{"application_id":{"title":"Application Id","type":"string"},"client_id":{"title":"Client Id","type":"string"},"created_at":{"format":"date-time","title":"Created At","type":"string"},"environment":{"title":"Environment","type":"string"},"expires_at":{"format":"date-time","title":"Expires At","type":"string"},"id":{"format":"uuid","title":"Id","type":"string"},"last_used_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"title":"Last Used At"},"name":{"title":"Name","type":"string"},"revoked_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"title":"Revoked At"},"rotated_from_id":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"title":"Rotated From Id"},"scopes":{"items":{"type":"string"},"title":"Scopes","type":"array"},"status":{"title":"Status","type":"string"}},"required":["id","client_id","application_id","name","environment","scopes","status","expires_at","created_at","last_used_at","revoked_at","rotated_from_id"],"title":"ApiCredentialAdminResponse","type":"object"},"ArticleMappingAdminResponse":{"additionalProperties":false,"properties":{"active":{"title":"Active","type":"boolean"},"canonical_article_code":{"title":"Canonical Article Code","type":"string"},"canonical_article_id":{"format":"uuid","title":"Canonical Article Id","type":"string"},"canonical_article_name":{"title":"Canonical Article Name","type":"string"},"carrier_connection_id":{"format":"uuid","title":"Carrier Connection Id","type":"string"},"carrier_product_code":{"title":"Carrier Product Code","type":"string"},"carrier_product_configuration":{"additionalProperties":true,"title":"Carrier Product Configuration","type":"object"},"client_id":{"title":"Client Id","type":"string"},"id":{"format":"uuid","title":"Id","type":"string"},"options":{"items":{"$ref":"#/components/schemas/ArticleOptionMappingAdminResponse"},"title":"Options","type":"array"},"restrictions":{"$ref":"#/components/schemas/ShipmentRestrictionsResponse"},"version":{"title":"Version","type":"integer"}},"required":["id","client_id","carrier_connection_id","canonical_article_id","canonical_article_code","canonical_article_name","carrier_product_code","carrier_product_configuration","version","active","options","restrictions"],"title":"ArticleMappingAdminResponse","type":"object"},"ArticleOptionMappingAdminResponse":{"additionalProperties":false,"properties":{"canonical_option_code":{"title":"Canonical Option Code","type":"string"},"canonical_option_id":{"format":"uuid","title":"Canonical Option Id","type":"string"},"canonical_option_name":{"title":"Canonical Option Name","type":"string"},"carrier_product_configuration":{"additionalProperties":true,"title":"Carrier Product Configuration","type":"object"},"restrictions":{"$ref":"#/components/schemas/ShipmentRestrictionsResponse"}},"required":["canonical_option_id","canonical_option_code","canonical_option_name","carrier_product_configuration","restrictions"],"title":"ArticleOptionMappingAdminResponse","type":"object"},"ArticleOptionResponse":{"additionalProperties":false,"properties":{"code":{"title":"Code","type":"string"},"name":{"title":"Name","type":"string"}},"required":["code","name"],"title":"ArticleOptionResponse","type":"object"},"ArticleResponse":{"additionalProperties":false,"properties":{"code":{"title":"Code","type":"string"},"name":{"title":"Name","type":"string"},"options":{"items":{"$ref":"#/components/schemas/ArticleOptionResponse"},"title":"Options","type":"array"}},"required":["code","name"],"title":"ArticleResponse","type":"object"},"AuditEventAdminResponse":{"additionalProperties":false,"properties":{"aggregate_id":{"title":"Aggregate Id","type":"string"},"aggregate_type":{"title":"Aggregate Type","type":"string"},"client_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Client Id"},"event_type":{"title":"Event Type","type":"string"},"id":{"format":"uuid","title":"Id","type":"string"},"occurred_at":{"format":"date-time","title":"Occurred At","type":"string"},"payload":{"additionalProperties":true,"title":"Payload","type":"object"}},"required":["id","client_id","event_type","aggregate_type","aggregate_id","payload","occurred_at"],"title":"AuditEventAdminResponse","type":"object"},"CancelCarrierProviderApplicationChangePlanRequest":{"additionalProperties":false,"properties":{"evidence_reference":{"maxLength":500,"minLength":1,"title":"Evidence Reference","type":"string"},"reason":{"maxLength":500,"minLength":1,"title":"Reason","type":"string"}},"required":["reason","evidence_reference"],"title":"CancelCarrierProviderApplicationChangePlanRequest","type":"object"},"CanonicalArticleAdminResponse":{"additionalProperties":false,"properties":{"active":{"title":"Active","type":"boolean"},"code":{"title":"Code","type":"string"},"created_at":{"format":"date-time","title":"Created At","type":"string"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"id":{"format":"uuid","title":"Id","type":"string"},"name":{"title":"Name","type":"string"},"updated_at":{"format":"date-time","title":"Updated At","type":"string"}},"required":["id","code","name","description","active","created_at","updated_at"],"title":"CanonicalArticleAdminResponse","type":"object"},"CanonicalOptionAdminResponse":{"additionalProperties":false,"properties":{"active":{"title":"Active","type":"boolean"},"code":{"title":"Code","type":"string"},"created_at":{"format":"date-time","title":"Created At","type":"string"},"description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Description"},"id":{"format":"uuid","title":"Id","type":"string"},"name":{"title":"Name","type":"string"},"updated_at":{"format":"date-time","title":"Updated At","type":"string"}},"required":["id","code","name","description","active","created_at","updated_at"],"title":"CanonicalOptionAdminResponse","type":"object"},"CarrierAdapterAdminResponse":{"additionalProperties":false,"properties":{"api_style":{"title":"Api Style","type":"string"},"capabilities":{"items":{"type":"string"},"title":"Capabilities","type":"array"},"code":{"title":"Code","type":"string"},"credential_fields":{"items":{"type":"string"},"title":"Credential Fields","type":"array"},"display_name":{"title":"Display Name","type":"string"},"documentation_slug":{"title":"Documentation Slug","type":"string"},"enabled_capabilities":{"items":{"type":"string"},"title":"Enabled Capabilities","type":"array"},"enabled_environments":{"items":{"type":"string"},"title":"Enabled Environments","type":"array"},"global_article_mapping_enabled":{"title":"Global Article Mapping Enabled","type":"boolean"},"implemented_environments":{"items":{"type":"string"},"title":"Implemented Environments","type":"array"},"integration_status":{"title":"Integration Status","type":"string"},"origin_configuration_fields":{"items":{"type":"string"},"title":"Origin Configuration Fields","type":"array"},"product_configuration_fields":{"items":{"type":"string"},"title":"Product Configuration Fields","type":"array"},"provider_probe_supported":{"title":"Provider Probe Supported","type":"boolean"},"requires_credentials":{"title":"Requires Credentials","type":"boolean"}},"required":["code","display_name","api_style","integration_status","capabilities","enabled_capabilities","implemented_environments","enabled_environments","requires_credentials","provider_probe_supported","global_article_mapping_enabled","credential_fields","product_configuration_fields","origin_configuration_fields","documentation_slug"],"title":"CarrierAdapterAdminResponse","type":"object"},"CarrierCheckpointState":{"enum":["ready","started"],"title":"CarrierCheckpointState","type":"string"},"CarrierConnectionAdminResponse":{"additionalProperties":false,"properties":{"article_resolution_mode":{"title":"Article Resolution Mode","type":"string"},"carrier_code":{"title":"Carrier Code","type":"string"},"client_id":{"title":"Client Id","type":"string"},"credential_configured":{"title":"Credential Configured","type":"boolean"},"credential_secret_ref":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Credential Secret Ref"},"display_name":{"title":"Display Name","type":"string"},"enabled_capabilities":{"items":{"type":"string"},"title":"Enabled Capabilities","type":"array"},"environment":{"title":"Environment","type":"string"},"id":{"format":"uuid","title":"Id","type":"string"},"provider_application_id":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"title":"Provider Application Id"},"status":{"title":"Status","type":"string"}},"required":["id","client_id","carrier_code","display_name","environment","status","credential_secret_ref","credential_configured","enabled_capabilities","provider_application_id","article_resolution_mode"],"title":"CarrierConnectionAdminResponse","type":"object"},"CarrierConnectionValidationResponse":{"additionalProperties":false,"properties":{"activated":{"title":"Activated","type":"boolean"},"checked_at":{"format":"date-time","title":"Checked At","type":"string"},"configuration_status":{"title":"Configuration Status","type":"string"},"connection":{"$ref":"#/components/schemas/CarrierConnectionAdminResponse"},"credentials_status":{"title":"Credentials Status","type":"string"},"detail":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Detail"},"duration_ms":{"title":"Duration Ms","type":"number"},"error_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Code"},"outcome":{"title":"Outcome","type":"string"},"provider_probe_requested":{"title":"Provider Probe Requested","type":"boolean"},"provider_status":{"title":"Provider Status","type":"string"}},"required":["connection","outcome","configuration_status","credentials_status","provider_status","provider_probe_requested","activated","checked_at","duration_ms"],"title":"CarrierConnectionValidationResponse","type":"object"},"CarrierCredentialRegistrationResponse":{"properties":{"carrier_connection_id":{"format":"uuid","title":"Carrier Connection Id","type":"string"},"connection_status":{"title":"Connection Status","type":"string"},"credential_configured":{"title":"Credential Configured","type":"boolean"}},"required":["carrier_connection_id","credential_configured","connection_status"],"title":"CarrierCredentialRegistrationResponse","type":"object"},"CarrierOperationalDiagnosticResponse":{"additionalProperties":false,"properties":{"carrier_code":{"title":"Carrier Code","type":"string"},"circuit_opened_until":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"title":"Circuit Opened Until"},"circuit_state":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Circuit State"},"circuit_updated_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"title":"Circuit Updated At"},"consecutive_failures":{"title":"Consecutive Failures","type":"integer"},"display_name":{"title":"Display Name","type":"string"},"environment":{"title":"Environment","type":"string"},"health":{"title":"Health","type":"string"},"integration_status":{"title":"Integration Status","type":"string"},"last_error_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Error Code"},"last_failure_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"title":"Last Failure At"},"last_observed_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"title":"Last Observed At"},"last_poll_duration_ms":{"anyOf":[{"type":"number"},{"type":"null"}],"title":"Last Poll Duration Ms"},"last_poll_outcome":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Poll Outcome"},"last_success_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"title":"Last Success At"},"provider_probe_supported":{"title":"Provider Probe Supported","type":"boolean"},"tracking_enabled":{"title":"Tracking Enabled","type":"boolean"},"tracking_implemented":{"title":"Tracking Implemented","type":"boolean"}},"required":["carrier_code","display_name","environment","integration_status","tracking_implemented","tracking_enabled","provider_probe_supported","health","circuit_state","consecutive_failures","circuit_opened_until","circuit_updated_at","last_poll_outcome","last_error_code","last_poll_duration_ms","last_observed_at","last_success_at","last_failure_at"],"title":"CarrierOperationalDiagnosticResponse","type":"object"},"CarrierProductValidationResponse":{"additionalProperties":false,"properties":{"carrier_code":{"title":"Carrier Code","type":"string"},"carrier_connection_id":{"format":"uuid","title":"Carrier Connection Id","type":"string"},"carrier_product_code":{"title":"Carrier Product Code","type":"string"},"checked_at":{"format":"date-time","title":"Checked At","type":"string"},"detail":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Detail"},"error_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Error Code"},"valid":{"title":"Valid","type":"boolean"},"validation_level":{"title":"Validation Level","type":"string"}},"required":["carrier_connection_id","carrier_code","carrier_product_code","valid","validation_level","checked_at"],"title":"CarrierProductValidationResponse","type":"object"},"CarrierProviderApplicationAdminResponse":{"additionalProperties":false,"properties":{"auth_mode":{"$ref":"#/components/schemas/CarrierProviderApplicationAuthMode"},"carrier_code":{"title":"Carrier Code","type":"string"},"created_at":{"format":"date-time","title":"Created At","type":"string"},"environment":{"title":"Environment","type":"string"},"id":{"format":"uuid","title":"Id","type":"string"},"name":{"title":"Name","type":"string"},"secret_configured":{"title":"Secret Configured","type":"boolean"},"status":{"$ref":"#/components/schemas/CarrierProviderApplicationStatus"},"updated_at":{"format":"date-time","title":"Updated At","type":"string"}},"required":["id","carrier_code","name","environment","auth_mode","status","secret_configured","created_at","updated_at"],"title":"CarrierProviderApplicationAdminResponse","type":"object"},"CarrierProviderApplicationAuthMode":{"enum":["connection_credentials","platform_authorization_code","platform_subordinate_credentials"],"title":"CarrierProviderApplicationAuthMode","type":"string"},"CarrierProviderApplicationChangeAction":{"enum":["rotate","disable"],"title":"CarrierProviderApplicationChangeAction","type":"string"},"CarrierProviderApplicationChangePlanResponse":{"additionalProperties":false,"properties":{"action":{"$ref":"#/components/schemas/CarrierProviderApplicationChangeAction"},"application_id":{"format":"uuid","title":"Application Id","type":"string"},"blockers":{"items":{"type":"string"},"title":"Blockers","type":"array"},"created_at":{"format":"date-time","title":"Created At","type":"string"},"evidence_reference":{"title":"Evidence Reference","type":"string"},"expected_application_updated_at":{"format":"date-time","title":"Expected Application Updated At","type":"string"},"expires_at":{"format":"date-time","title":"Expires At","type":"string"},"id":{"format":"uuid","title":"Id","type":"string"},"impact":{"$ref":"#/components/schemas/CarrierProviderApplicationImpactResponse"},"ready_for_approval":{"title":"Ready For Approval","type":"boolean"},"reason":{"title":"Reason","type":"string"},"requested_by":{"title":"Requested By","type":"string"},"status":{"$ref":"#/components/schemas/CarrierProviderApplicationChangePlanStatus"},"status_actor_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status Actor Id"},"status_changed_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"title":"Status Changed At"},"status_evidence_reference":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status Evidence Reference"},"status_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Status Reason"},"warnings":{"items":{"type":"string"},"title":"Warnings","type":"array"}},"required":["id","application_id","action","status","expected_application_updated_at","reason","evidence_reference","impact","blockers","warnings","ready_for_approval","requested_by","created_at","expires_at","status_changed_at","status_reason","status_evidence_reference","status_actor_id"],"title":"CarrierProviderApplicationChangePlanResponse","type":"object"},"CarrierProviderApplicationChangePlanStatus":{"enum":["pending_human_review","cancelled","expired"],"title":"CarrierProviderApplicationChangePlanStatus","type":"string"},"CarrierProviderApplicationConnectionImpactResponse":{"additionalProperties":false,"properties":{"client_id":{"title":"Client Id","type":"string"},"connection_id":{"format":"uuid","title":"Connection Id","type":"string"},"connection_status":{"title":"Connection Status","type":"string"},"currently_linked":{"title":"Currently Linked","type":"boolean"},"last_used_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"title":"Last Used At"},"pending_reconciliations_count":{"title":"Pending Reconciliations Count","type":"integer"},"reconciliations_count":{"title":"Reconciliations Count","type":"integer"},"shipments_count":{"title":"Shipments Count","type":"integer"}},"required":["connection_id","client_id","connection_status","currently_linked","shipments_count","reconciliations_count","pending_reconciliations_count","last_used_at"],"title":"CarrierProviderApplicationConnectionImpactResponse","type":"object"},"CarrierProviderApplicationImpactResponse":{"additionalProperties":false,"properties":{"active_linked_connections_count":{"title":"Active Linked Connections Count","type":"integer"},"affected_clients_count":{"title":"Affected Clients Count","type":"integer"},"application_id":{"format":"uuid","title":"Application Id","type":"string"},"application_status":{"$ref":"#/components/schemas/CarrierProviderApplicationStatus"},"carrier_code":{"title":"Carrier Code","type":"string"},"connections":{"items":{"$ref":"#/components/schemas/CarrierProviderApplicationConnectionImpactResponse"},"title":"Connections","type":"array"},"environment":{"title":"Environment","type":"string"},"last_used_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"title":"Last Used At"},"linked_connections_count":{"title":"Linked Connections Count","type":"integer"},"pending_reconciliations_count":{"title":"Pending Reconciliations Count","type":"integer"},"reconciliations_count":{"title":"Reconciliations Count","type":"integer"},"shipments_count":{"title":"Shipments Count","type":"integer"}},"required":["application_id","carrier_code","environment","application_status","linked_connections_count","active_linked_connections_count","affected_clients_count","shipments_count","reconciliations_count","pending_reconciliations_count","last_used_at","connections"],"title":"CarrierProviderApplicationImpactResponse","type":"object"},"CarrierProviderApplicationStatus":{"enum":["draft","disabled","active"],"title":"CarrierProviderApplicationStatus","type":"string"},"CarrierServiceDiscoveryResponse":{"additionalProperties":false,"properties":{"availability":{"enum":["contracted","reference","unavailable"],"title":"Availability","type":"string"},"checked_at":{"format":"date-time","title":"Checked At","type":"string"},"detail":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Detail"},"scope":{"title":"Scope","type":"string"},"services":{"items":{"$ref":"#/components/schemas/DiscoveredCarrierServiceResponse"},"title":"Services","type":"array"},"source":{"title":"Source","type":"string"}},"required":["availability","source","scope","checked_at","services","detail"],"title":"CarrierServiceDiscoveryResponse","type":"object"},"CarrierServiceProposalResponse":{"properties":{"carrier_connection_id":{"format":"uuid","title":"Carrier Connection Id","type":"string"},"codes":{"items":{"type":"string"},"title":"Codes","type":"array"},"created_at":{"title":"Created At","type":"string"},"id":{"format":"uuid","title":"Id","type":"string"},"status":{"default":"active","title":"Status","type":"string"}},"required":["id","carrier_connection_id","codes","created_at"],"title":"CarrierServiceProposalResponse","type":"object"},"CarrierStatusMappingAdminResponse":{"additionalProperties":false,"properties":{"active":{"title":"Active","type":"boolean"},"canonical_status":{"$ref":"#/components/schemas/ShipmentStatus"},"carrier_code":{"title":"Carrier Code","type":"string"},"id":{"format":"uuid","title":"Id","type":"string"},"provider_status_code":{"title":"Provider Status Code","type":"string"},"version":{"title":"Version","type":"integer"}},"required":["id","carrier_code","provider_status_code","canonical_status","version","active"],"title":"CarrierStatusMappingAdminResponse","type":"object"},"ClientAdminResponse":{"additionalProperties":false,"properties":{"active":{"title":"Active","type":"boolean"},"created_at":{"format":"date-time","title":"Created At","type":"string"},"id":{"title":"Id","type":"string"},"name":{"title":"Name","type":"string"}},"required":["id","name","active","created_at"],"title":"ClientAdminResponse","type":"object"},"ConnectionArticleOptionResponse":{"additionalProperties":false,"properties":{"additional_restrictions":{"$ref":"#/components/schemas/ShipmentRestrictionsResponse"},"code":{"title":"Code","type":"string"},"name":{"title":"Name","type":"string"}},"required":["code","name","additional_restrictions"],"title":"ConnectionArticleOptionResponse","type":"object"},"ConnectionArticleResponse":{"additionalProperties":false,"properties":{"code":{"title":"Code","type":"string"},"code_system":{"default":"canonical_mapping","title":"Code System","type":"string"},"name":{"title":"Name","type":"string"},"options":{"items":{"$ref":"#/components/schemas/ConnectionArticleOptionResponse"},"title":"Options","type":"array"},"restrictions":{"$ref":"#/components/schemas/ShipmentRestrictionsResponse"}},"required":["code","name","options","restrictions"],"title":"ConnectionArticleResponse","type":"object"},"ConnectionOriginResponse":{"additionalProperties":false,"properties":{"code":{"title":"Code","type":"string"}},"required":["code"],"title":"ConnectionOriginResponse","type":"object"},"ConnectionResponse":{"additionalProperties":false,"properties":{"article_resolution_mode":{"title":"Article Resolution Mode","type":"string"},"carrier_code":{"title":"Carrier Code","type":"string"},"display_name":{"title":"Display Name","type":"string"},"enabled_capabilities":{"items":{"type":"string"},"title":"Enabled Capabilities","type":"array"},"environment":{"title":"Environment","type":"string"},"id":{"format":"uuid","title":"Id","type":"string"},"status":{"title":"Status","type":"string"}},"required":["id","carrier_code","display_name","environment","status","enabled_capabilities","article_resolution_mode"],"title":"ConnectionResponse","type":"object"},"ConnectionServiceAdminResponse":{"additionalProperties":false,"properties":{"active":{"title":"Active","type":"boolean"},"carrier_connection_id":{"format":"uuid","title":"Carrier Connection Id","type":"string"},"code":{"title":"Code","type":"string"},"created_at":{"format":"date-time","title":"Created At","type":"string"},"id":{"format":"uuid","title":"Id","type":"string"},"name":{"title":"Name","type":"string"},"source":{"title":"Source","type":"string"},"version":{"title":"Version","type":"integer"}},"required":["id","carrier_connection_id","code","name","version","active","source","created_at"],"title":"ConnectionServiceAdminResponse","type":"object"},"ConnectionServiceEntitlementAdminResponse":{"additionalProperties":false,"properties":{"availability":{"title":"Availability","type":"string"},"carrier_connection_id":{"format":"uuid","title":"Carrier Connection Id","type":"string"},"carrier_product_code":{"title":"Carrier Product Code","type":"string"},"change_reason":{"title":"Change Reason","type":"string"},"client_id":{"title":"Client Id","type":"string"},"current":{"title":"Current","type":"boolean"},"evidence_reference":{"title":"Evidence Reference","type":"string"},"expires_at":{"format":"date-time","title":"Expires At","type":"string"},"id":{"format":"uuid","title":"Id","type":"string"},"recorded_at":{"format":"date-time","title":"Recorded At","type":"string"},"recorded_by":{"title":"Recorded By","type":"string"},"source":{"title":"Source","type":"string"},"verified_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"title":"Verified At"},"version":{"title":"Version","type":"integer"}},"required":["id","client_id","carrier_connection_id","carrier_product_code","availability","source","evidence_reference","verified_at","expires_at","version","current","recorded_by","change_reason","recorded_at"],"title":"ConnectionServiceEntitlementAdminResponse","type":"object"},"CreateArticleMappingRequest":{"additionalProperties":false,"properties":{"active":{"default":true,"title":"Active","type":"boolean"},"canonical_article_id":{"format":"uuid","title":"Canonical Article Id","type":"string"},"carrier_connection_id":{"format":"uuid","title":"Carrier Connection Id","type":"string"},"carrier_product_code":{"maxLength":100,"minLength":1,"title":"Carrier Product Code","type":"string"},"carrier_product_configuration":{"additionalProperties":true,"maxProperties":50,"title":"Carrier Product Configuration","type":"object"},"options":{"items":{"$ref":"#/components/schemas/CreateArticleOptionMappingRequest"},"maxItems":20,"title":"Options","type":"array"},"restrictions":{"$ref":"#/components/schemas/ShipmentRestrictionsRequest"}},"required":["carrier_connection_id","canonical_article_id","carrier_product_code"],"title":"CreateArticleMappingRequest","type":"object"},"CreateArticleOptionMappingRequest":{"additionalProperties":false,"properties":{"canonical_option_id":{"format":"uuid","title":"Canonical Option Id","type":"string"},"carrier_product_configuration":{"additionalProperties":true,"maxProperties":20,"minProperties":1,"title":"Carrier Product Configuration","type":"object"},"restrictions":{"$ref":"#/components/schemas/ShipmentRestrictionsRequest"}},"required":["canonical_option_id","carrier_product_configuration"],"title":"CreateArticleOptionMappingRequest","type":"object"},"CreateCanonicalArticleRequest":{"additionalProperties":false,"properties":{"code":{"maxLength":50,"minLength":1,"title":"Code","type":"string"},"description":{"anyOf":[{"maxLength":1000,"type":"string"},{"type":"null"}],"title":"Description"},"name":{"maxLength":200,"minLength":1,"title":"Name","type":"string"}},"required":["code","name"],"title":"CreateCanonicalArticleRequest","type":"object"},"CreateCanonicalOptionRequest":{"additionalProperties":false,"properties":{"code":{"maxLength":50,"minLength":1,"title":"Code","type":"string"},"description":{"anyOf":[{"maxLength":1000,"type":"string"},{"type":"null"}],"title":"Description"},"name":{"maxLength":200,"minLength":1,"title":"Name","type":"string"}},"required":["code","name"],"title":"CreateCanonicalOptionRequest","type":"object"},"CreateCarrierConnectionRequest":{"additionalProperties":false,"properties":{"article_resolution_mode":{"anyOf":[{"enum":["canonical_mapping","connection_service_code"],"type":"string"},{"type":"null"}],"title":"Article Resolution Mode"},"carrier_code":{"maxLength":100,"minLength":1,"title":"Carrier Code","type":"string"},"credential_secret_ref":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"title":"Credential Secret Ref"},"display_name":{"maxLength":200,"minLength":1,"title":"Display Name","type":"string"},"environment":{"enum":["local","test","sandbox","production"],"title":"Environment","type":"string"},"provider_application_id":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"title":"Provider Application Id"}},"required":["carrier_code","display_name","environment"],"title":"CreateCarrierConnectionRequest","type":"object"},"CreateCarrierProviderApplicationChangePlanRequest":{"additionalProperties":false,"properties":{"action":{"$ref":"#/components/schemas/CarrierProviderApplicationChangeAction"},"evidence_reference":{"maxLength":500,"minLength":1,"title":"Evidence Reference","type":"string"},"expected_application_updated_at":{"format":"date-time","title":"Expected Application Updated At","type":"string"},"reason":{"maxLength":500,"minLength":1,"title":"Reason","type":"string"}},"required":["action","expected_application_updated_at","reason","evidence_reference"],"title":"CreateCarrierProviderApplicationChangePlanRequest","type":"object"},"CreateCarrierProviderApplicationRequest":{"additionalProperties":false,"properties":{"application_secret_ref":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"title":"Application Secret Ref"},"auth_mode":{"$ref":"#/components/schemas/CarrierProviderApplicationAuthMode"},"carrier_code":{"maxLength":100,"minLength":1,"title":"Carrier Code","type":"string"},"environment":{"enum":["local","test","sandbox","production"],"title":"Environment","type":"string"},"name":{"maxLength":200,"minLength":1,"title":"Name","type":"string"}},"required":["carrier_code","name","environment","auth_mode"],"title":"CreateCarrierProviderApplicationRequest","type":"object"},"CreateCarrierStatusMappingRequest":{"additionalProperties":false,"properties":{"active":{"default":true,"title":"Active","type":"boolean"},"canonical_status":{"$ref":"#/components/schemas/ShipmentStatus"},"provider_status_code":{"maxLength":100,"minLength":1,"title":"Provider Status Code","type":"string"}},"required":["provider_status_code","canonical_status"],"title":"CreateCarrierStatusMappingRequest","type":"object"},"CreateClientRequest":{"additionalProperties":false,"properties":{"id":{"maxLength":100,"minLength":1,"pattern":"^[a-z0-9][a-z0-9_-]*$","title":"Id","type":"string"},"name":{"maxLength":200,"minLength":1,"title":"Name","type":"string"}},"required":["id","name"],"title":"CreateClientRequest","type":"object"},"CreateConnectionServiceRequest":{"additionalProperties":false,"properties":{"active":{"default":false,"title":"Active","type":"boolean"},"code":{"maxLength":100,"minLength":1,"title":"Code","type":"string"},"name":{"maxLength":200,"minLength":1,"title":"Name","type":"string"},"reason":{"maxLength":500,"minLength":1,"title":"Reason","type":"string"},"source":{"default":"manual","enum":["manual","reference"],"title":"Source","type":"string"}},"required":["code","name","reason"],"title":"CreateConnectionServiceRequest","type":"object"},"CreateOriginMappingRequest":{"additionalProperties":false,"properties":{"active":{"default":true,"title":"Active","type":"boolean"},"carrier_connection_id":{"format":"uuid","title":"Carrier Connection Id","type":"string"},"carrier_origin_configuration":{"additionalProperties":{"type":"string"},"maxProperties":20,"minProperties":1,"title":"Carrier Origin Configuration","type":"object"},"origin_code":{"maxLength":50,"minLength":1,"pattern":"^[A-Za-z0-9][A-Za-z0-9._-]*$","title":"Origin Code","type":"string"}},"required":["carrier_connection_id","origin_code","carrier_origin_configuration"],"title":"CreateOriginMappingRequest","type":"object"},"CreatePlatformArticleMappingRequest":{"additionalProperties":false,"properties":{"active":{"default":false,"title":"Active","type":"boolean"},"canonical_article_id":{"format":"uuid","title":"Canonical Article Id","type":"string"},"carrier_product_code":{"maxLength":100,"minLength":1,"title":"Carrier Product Code","type":"string"},"carrier_product_configuration":{"additionalProperties":true,"maxProperties":50,"title":"Carrier Product Configuration","type":"object"},"change_reason":{"maxLength":1000,"minLength":1,"title":"Change Reason","type":"string"},"options":{"items":{"$ref":"#/components/schemas/CreateArticleOptionMappingRequest"},"maxItems":20,"title":"Options","type":"array"},"restrictions":{"$ref":"#/components/schemas/ShipmentRestrictionsRequest"}},"required":["canonical_article_id","carrier_product_code","change_reason"],"title":"CreatePlatformArticleMappingRequest","type":"object"},"CreateReverseLogisticsRequest":{"additionalProperties":false,"properties":{"article_code":{"maxLength":50,"minLength":1,"title":"Article Code","type":"string"},"external_reference":{"anyOf":[{"maxLength":100,"minLength":1,"type":"string"},{"type":"null"}],"title":"External Reference"},"packages":{"anyOf":[{"items":{"$ref":"#/components/schemas/PackageRequest"},"maxItems":100,"minItems":1,"type":"array"},{"type":"null"}],"title":"Packages"},"pickup_address":{"anyOf":[{"$ref":"#/components/schemas/RecipientRequest"},{"type":"null"}]},"pickup_date":{"format":"date","title":"Pickup Date","type":"string"},"pickup_instructions":{"anyOf":[{"maxLength":500,"minLength":1,"type":"string"},{"type":"null"}],"title":"Pickup Instructions"},"pickup_window_from":{"pattern":"^([01]\\d|2[0-3]):[0-5]\\d$","title":"Pickup Window From","type":"string"},"pickup_window_to":{"pattern":"^([01]\\d|2[0-3]):[0-5]\\d$","title":"Pickup Window To","type":"string"},"return_address":{"anyOf":[{"$ref":"#/components/schemas/RecipientRequest"},{"type":"null"}]}},"required":["article_code","pickup_date","pickup_window_from","pickup_window_to"],"title":"CreateReverseLogisticsRequest","type":"object"},"CreateShipmentRequest":{"additionalProperties":false,"properties":{"article_code":{"maxLength":50,"minLength":1,"title":"Article Code","type":"string"},"carrier_connection_id":{"format":"uuid","title":"Carrier Connection Id","type":"string"},"customs":{"anyOf":[{"$ref":"#/components/schemas/CustomsDeclarationRequest"},{"type":"null"}]},"external_reference":{"anyOf":[{"maxLength":100,"minLength":1,"type":"string"},{"type":"null"}],"title":"External Reference"},"option_codes":{"items":{"maxLength":50,"minLength":1,"type":"string"},"maxItems":20,"title":"Option Codes","type":"array"},"origin_code":{"anyOf":[{"maxLength":50,"minLength":1,"pattern":"^[A-Za-z0-9][A-Za-z0-9._-]*$","type":"string"},{"type":"null"}],"title":"Origin Code"},"packages":{"items":{"$ref":"#/components/schemas/PackageRequest"},"maxItems":100,"minItems":1,"title":"Packages","type":"array"},"pudo_point_id":{"anyOf":[{"maxLength":200,"minLength":1,"type":"string"},{"type":"null"}],"title":"Pudo Point Id"},"recipient":{"$ref":"#/components/schemas/RecipientRequest"},"sender":{"anyOf":[{"$ref":"#/components/schemas/RecipientRequest"},{"type":"null"}]},"shipping_date":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"title":"Shipping Date"}},"required":["carrier_connection_id","article_code","recipient","packages"],"title":"CreateShipmentRequest","type":"object"},"CreateWebhookSubscriptionRequest":{"additionalProperties":false,"properties":{"event_types":{"items":{"type":"string"},"minItems":1,"title":"Event Types","type":"array","uniqueItems":true},"url":{"maxLength":2048,"minLength":1,"title":"Url","type":"string"}},"required":["url","event_types"],"title":"CreateWebhookSubscriptionRequest","type":"object"},"CustomsContentType":{"enum":["documents","merchandise"],"title":"CustomsContentType","type":"string"},"CustomsDeclarationRequest":{"additionalProperties":false,"properties":{"content_type":{"$ref":"#/components/schemas/CustomsContentType"},"currency_code":{"anyOf":[{"pattern":"^[A-Za-z]{3}$","type":"string"},{"type":"null"}],"title":"Currency Code"},"duties_payer":{"anyOf":[{"$ref":"#/components/schemas/CustomsDutiesPayer"},{"type":"null"}]},"export_reason":{"$ref":"#/components/schemas/CustomsExportReason"},"exporter_registrations":{"items":{"$ref":"#/components/schemas/CustomsRegistrationNumberRequest"},"maxItems":20,"title":"Exporter Registrations","type":"array"},"freight_charge":{"anyOf":[{"minimum":0,"type":"number"},{"pattern":"^(?!^[-+.]*$)[+-]?0*(?:\\d{0,14}|(?=[\\d.]{1,19}0*$)\\d{0,14}\\.\\d{0,4}0*$)","type":"string"},{"type":"null"}],"title":"Freight Charge"},"importer_registrations":{"items":{"$ref":"#/components/schemas/CustomsRegistrationNumberRequest"},"maxItems":20,"title":"Importer Registrations","type":"array"},"incoterm":{"anyOf":[{"pattern":"^[A-Za-z]{3}$","type":"string"},{"type":"null"}],"title":"Incoterm"},"insurance_charge":{"anyOf":[{"minimum":0,"type":"number"},{"pattern":"^(?!^[-+.]*$)[+-]?0*(?:\\d{0,14}|(?=[\\d.]{1,19}0*$)\\d{0,14}\\.\\d{0,4}0*$)","type":"string"},{"type":"null"}],"title":"Insurance Charge"},"invoice_date":{"anyOf":[{"format":"date","type":"string"},{"type":"null"}],"title":"Invoice Date"},"invoice_number":{"anyOf":[{"maxLength":100,"minLength":1,"type":"string"},{"type":"null"}],"title":"Invoice Number"},"invoice_type":{"anyOf":[{"$ref":"#/components/schemas/CustomsInvoiceType"},{"type":"null"}]},"items":{"items":{"$ref":"#/components/schemas/CustomsItemRequest"},"maxItems":100,"title":"Items","type":"array"},"other_charge":{"anyOf":[{"minimum":0,"type":"number"},{"pattern":"^(?!^[-+.]*$)[+-]?0*(?:\\d{0,14}|(?=[\\d.]{1,19}0*$)\\d{0,14}\\.\\d{0,4}0*$)","type":"string"},{"type":"null"}],"title":"Other Charge"},"remarks":{"anyOf":[{"maxLength":500,"minLength":1,"type":"string"},{"type":"null"}],"title":"Remarks"}},"required":["content_type","export_reason"],"title":"CustomsDeclarationRequest","type":"object"},"CustomsDutiesPayer":{"enum":["sender","recipient"],"title":"CustomsDutiesPayer","type":"string"},"CustomsExportReason":{"enum":["sale","gift","sample","return","repair","personal_effects","other"],"title":"CustomsExportReason","type":"string"},"CustomsInvoiceType":{"enum":["commercial","proforma"],"title":"CustomsInvoiceType","type":"string"},"CustomsItemRequest":{"additionalProperties":false,"properties":{"description":{"maxLength":200,"minLength":1,"title":"Description","type":"string"},"hs_code":{"anyOf":[{"maxLength":14,"minLength":4,"pattern":"^[0-9.]+$","type":"string"},{"type":"null"}],"title":"Hs Code"},"net_weight_kg":{"anyOf":[{"exclusiveMinimum":0,"maximum":100000,"type":"number"},{"pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$","type":"string"}],"title":"Net Weight Kg"},"origin_country_code":{"pattern":"^[A-Za-z]{2}$","title":"Origin Country Code","type":"string"},"quantity":{"maximum":1000000,"minimum":1,"title":"Quantity","type":"integer"},"sku":{"anyOf":[{"maxLength":100,"minLength":1,"type":"string"},{"type":"null"}],"title":"Sku"},"unit_value":{"anyOf":[{"exclusiveMinimum":0,"type":"number"},{"pattern":"^(?!^[-+.]*$)[+-]?0*(?:\\d{0,14}|(?=[\\d.]{1,19}0*$)\\d{0,14}\\.\\d{0,4}0*$)","type":"string"}],"title":"Unit Value"}},"required":["description","quantity","unit_value","net_weight_kg","origin_country_code"],"title":"CustomsItemRequest","type":"object"},"CustomsRegistrationNumberRequest":{"additionalProperties":false,"properties":{"issuer_country_code":{"anyOf":[{"pattern":"^[A-Za-z]{2}$","type":"string"},{"type":"null"}],"title":"Issuer Country Code"},"number":{"maxLength":80,"minLength":1,"title":"Number","type":"string"},"type":{"$ref":"#/components/schemas/CustomsRegistrationType"}},"required":["type","number"],"title":"CustomsRegistrationNumberRequest","type":"object"},"CustomsRegistrationType":{"enum":["eori","vat","ioss","tax","other"],"title":"CustomsRegistrationType","type":"string"},"DiscoveredCarrierServiceResponse":{"additionalProperties":false,"properties":{"code":{"title":"Code","type":"string"},"name":{"title":"Name","type":"string"},"network_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Network Code"}},"required":["code","name","network_code"],"title":"DiscoveredCarrierServiceResponse","type":"object"},"EcommConnectionProvisionRequest":{"properties":{"display_name":{"maxLength":200,"minLength":1,"title":"Display Name","type":"string"}},"required":["display_name"],"title":"EcommConnectionProvisionRequest","type":"object"},"EcommConnectionProvisionResponse":{"properties":{"carrier_connection_id":{"format":"uuid","title":"Carrier Connection Id","type":"string"},"client_id":{"title":"Client Id","type":"string"},"connection_status":{"title":"Connection Status","type":"string"},"entitlement":{"title":"Entitlement","type":"string"}},"required":["client_id","carrier_connection_id","connection_status","entitlement"],"title":"EcommConnectionProvisionResponse","type":"object"},"EcommConnectionStateResponse":{"properties":{"carrier_connection_id":{"format":"uuid","title":"Carrier Connection Id","type":"string"},"credential_configured":{"title":"Credential Configured","type":"boolean"},"display_name":{"title":"Display Name","type":"string"},"external_integration_id":{"format":"uuid","title":"External Integration Id","type":"string"},"status":{"title":"Status","type":"string"}},"required":["external_integration_id","carrier_connection_id","display_name","status","credential_configured"],"title":"EcommConnectionStateResponse","type":"object"},"EcommCredentialResponse":{"properties":{"api_key":{"title":"Api Key","type":"string"},"client_id":{"title":"Client Id","type":"string"},"credential_id":{"format":"uuid","title":"Credential Id","type":"string"},"expires_at":{"format":"date-time","title":"Expires At","type":"string"},"scopes":{"items":{"type":"string"},"title":"Scopes","type":"array"}},"required":["credential_id","client_id","expires_at","scopes","api_key"],"title":"EcommCredentialResponse","type":"object"},"EcommWorkspaceStateResponse":{"properties":{"client_active":{"title":"Client Active","type":"boolean"},"client_id":{"title":"Client Id","type":"string"},"connections":{"items":{"$ref":"#/components/schemas/EcommConnectionStateResponse"},"title":"Connections","type":"array"},"entitlement":{"title":"Entitlement","type":"string"},"logistics_credential_active":{"title":"Logistics Credential Active","type":"boolean"},"management_credential_active":{"title":"Management Credential Active","type":"boolean"},"status":{"title":"Status","type":"string"},"workspace_id":{"title":"Workspace Id","type":"integer"}},"required":["workspace_id","client_id","status","entitlement","client_active","management_credential_active","logistics_credential_active","connections"],"title":"EcommWorkspaceStateResponse","type":"object"},"EcommWorkspaceStatusRequest":{"properties":{"status":{"enum":["active","suspended"],"title":"Status","type":"string"}},"required":["status"],"title":"EcommWorkspaceStatusRequest","type":"object"},"HTTPValidationError":{"properties":{"detail":{"items":{"$ref":"#/components/schemas/ValidationError"},"title":"Detail","type":"array"}},"title":"HTTPValidationError","type":"object"},"HealthResponse":{"additionalProperties":false,"properties":{"status":{"title":"Status","type":"string"}},"required":["status"],"title":"HealthResponse","type":"object"},"IncidentCategory":{"enum":["address_issue","damage","delay","loss","recipient_unavailable","other"],"title":"IncidentCategory","type":"string"},"IncidentPageResponse":{"additionalProperties":false,"properties":{"items":{"items":{"$ref":"#/components/schemas/IncidentResponse"},"title":"Items","type":"array"},"next_cursor":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"title":"Next Cursor"}},"required":["items","next_cursor"],"title":"IncidentPageResponse","type":"object"},"IncidentReportResponse":{"additionalProperties":false,"properties":{"category":{"$ref":"#/components/schemas/IncidentCategory"},"incident_id":{"format":"uuid","title":"Incident Id","type":"string"},"shipment_id":{"format":"uuid","title":"Shipment Id","type":"string"},"status":{"const":"submitted","default":"submitted","title":"Status","type":"string"}},"required":["incident_id","shipment_id","category"],"title":"IncidentReportResponse","type":"object"},"IncidentReportingPolicyResponse":{"additionalProperties":false,"properties":{"allowed_statuses":{"items":{"$ref":"#/components/schemas/ShipmentStatus"},"title":"Allowed Statuses","type":"array"},"available":{"title":"Available","type":"boolean"},"categories":{"items":{"$ref":"#/components/schemas/IncidentCategory"},"title":"Categories","type":"array"},"conditions":{"items":{"type":"string"},"title":"Conditions","type":"array"},"current_status":{"$ref":"#/components/schemas/ShipmentStatus"},"reason_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reason Code"},"shipment_id":{"format":"uuid","title":"Shipment Id","type":"string"}},"required":["shipment_id","available","current_status","categories","allowed_statuses","reason_code","conditions"],"title":"IncidentReportingPolicyResponse","type":"object"},"IncidentResponse":{"additionalProperties":false,"properties":{"category":{"$ref":"#/components/schemas/IncidentCategory"},"created_at":{"format":"date-time","title":"Created At","type":"string"},"customer_reference":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Customer Reference"},"incident_id":{"format":"uuid","title":"Incident Id","type":"string"},"provider_reference":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provider Reference"},"resolved_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"title":"Resolved At"},"shipment_id":{"format":"uuid","title":"Shipment Id","type":"string"},"status":{"$ref":"#/components/schemas/IncidentStatus"},"status_updated_at":{"format":"date-time","title":"Status Updated At","type":"string"}},"required":["incident_id","shipment_id","category","status","customer_reference","provider_reference","created_at","status_updated_at","resolved_at"],"title":"IncidentResponse","type":"object"},"IncidentStatus":{"enum":["submitted","processing","resolved","rejected","unknown"],"title":"IncidentStatus","type":"string"},"IssueApiCredentialRequest":{"additionalProperties":false,"properties":{"application_id":{"maxLength":100,"minLength":1,"title":"Application Id","type":"string"},"environment":{"enum":["local","test","sandbox","production"],"title":"Environment","type":"string"},"expires_in_days":{"default":90,"maximum":365,"minimum":1,"title":"Expires In Days","type":"integer"},"name":{"maxLength":200,"minLength":1,"title":"Name","type":"string"},"rotated_from_id":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"title":"Rotated From Id"},"scopes":{"items":{"type":"string"},"maxItems":10,"minItems":1,"title":"Scopes","type":"array","uniqueItems":true}},"required":["application_id","name","environment","scopes"],"title":"IssueApiCredentialRequest","type":"object"},"IssuedApiCredentialResponse":{"additionalProperties":false,"properties":{"api_key":{"description":"Se muestra una sola vez y no puede recuperarse posteriormente","title":"Api Key","type":"string"},"application_id":{"title":"Application Id","type":"string"},"client_id":{"title":"Client Id","type":"string"},"created_at":{"format":"date-time","title":"Created At","type":"string"},"environment":{"title":"Environment","type":"string"},"expires_at":{"format":"date-time","title":"Expires At","type":"string"},"id":{"format":"uuid","title":"Id","type":"string"},"last_used_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"title":"Last Used At"},"name":{"title":"Name","type":"string"},"revoked_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"title":"Revoked At"},"rotated_from_id":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"title":"Rotated From Id"},"scopes":{"items":{"type":"string"},"title":"Scopes","type":"array"},"status":{"title":"Status","type":"string"}},"required":["id","client_id","application_id","name","environment","scopes","status","expires_at","created_at","last_used_at","revoked_at","rotated_from_id","api_key"],"title":"IssuedApiCredentialResponse","type":"object"},"IssuedWebhookSubscriptionResponse":{"additionalProperties":false,"properties":{"active":{"title":"Active","type":"boolean"},"created_at":{"format":"date-time","title":"Created At","type":"string"},"event_types":{"items":{"type":"string"},"title":"Event Types","type":"array"},"id":{"format":"uuid","title":"Id","type":"string"},"signing_secret":{"title":"Signing Secret","type":"string"},"updated_at":{"format":"date-time","title":"Updated At","type":"string"},"url":{"title":"Url","type":"string"},"version":{"title":"Version","type":"integer"}},"required":["id","url","event_types","active","version","created_at","updated_at","signing_secret"],"title":"IssuedWebhookSubscriptionResponse","type":"object"},"LabelResponse":{"additionalProperties":false,"properties":{"content_base64":{"title":"Content Base64","type":"string"},"format":{"title":"Format","type":"string"}},"required":["format","content_base64"],"title":"LabelResponse","type":"object"},"ModifyShipmentRequest":{"additionalProperties":false,"properties":{"external_reference":{"anyOf":[{"maxLength":100,"minLength":1,"type":"string"},{"type":"null"}],"title":"External Reference"},"package_weights_kg":{"anyOf":[{"items":{"anyOf":[{"exclusiveMinimum":0,"type":"number"},{"pattern":"^(?!^[-+.]*$)[+-]?0*(?:\\d{0,5}|(?=[\\d.]{1,9}0*$)\\d{0,5}\\.\\d{0,3}0*$)","type":"string"}]},"maxItems":100,"minItems":1,"type":"array"},{"type":"null"}],"title":"Package Weights Kg"},"recipient":{"anyOf":[{"$ref":"#/components/schemas/RecipientRequest"},{"type":"null"}]}},"title":"ModifyShipmentRequest","type":"object"},"OriginMappingAdminResponse":{"additionalProperties":false,"properties":{"active":{"title":"Active","type":"boolean"},"carrier_connection_id":{"format":"uuid","title":"Carrier Connection Id","type":"string"},"carrier_origin_configuration":{"additionalProperties":{"type":"string"},"title":"Carrier Origin Configuration","type":"object"},"client_id":{"title":"Client Id","type":"string"},"id":{"format":"uuid","title":"Id","type":"string"},"origin_code":{"title":"Origin Code","type":"string"},"version":{"title":"Version","type":"integer"}},"required":["id","client_id","carrier_connection_id","origin_code","carrier_origin_configuration","version","active"],"title":"OriginMappingAdminResponse","type":"object"},"OutboxMessageAdminResponse":{"additionalProperties":false,"properties":{"attempts":{"title":"Attempts","type":"integer"},"available_at":{"format":"date-time","title":"Available At","type":"string"},"client_id":{"title":"Client Id","type":"string"},"created_at":{"format":"date-time","title":"Created At","type":"string"},"id":{"format":"uuid","title":"Id","type":"string"},"last_error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Error"},"locked_until":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"title":"Locked Until"},"status":{"title":"Status","type":"string"},"topic":{"title":"Topic","type":"string"}},"required":["id","client_id","topic","status","attempts","available_at","locked_until","last_error","created_at"],"title":"OutboxMessageAdminResponse","type":"object"},"OutboxStatus":{"enum":["pending","processing","processed","dead_letter"],"title":"OutboxStatus","type":"string"},"PackageRequest":{"additionalProperties":false,"properties":{"height_cm":{"anyOf":[{"exclusiveMinimum":0,"maximum":1000,"type":"number"},{"pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$","type":"string"},{"type":"null"}],"title":"Height Cm"},"length_cm":{"anyOf":[{"exclusiveMinimum":0,"maximum":1000,"type":"number"},{"pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$","type":"string"},{"type":"null"}],"title":"Length Cm"},"weight_kg":{"anyOf":[{"exclusiveMinimum":0,"maximum":1000,"type":"number"},{"pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$","type":"string"}],"title":"Weight Kg"},"width_cm":{"anyOf":[{"exclusiveMinimum":0,"maximum":1000,"type":"number"},{"pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$","type":"string"},{"type":"null"}],"title":"Width Cm"}},"required":["weight_kg"],"title":"PackageRequest","type":"object"},"PlatformArticleMappingAdminResponse":{"additionalProperties":false,"properties":{"active":{"title":"Active","type":"boolean"},"canonical_article_code":{"title":"Canonical Article Code","type":"string"},"canonical_article_id":{"format":"uuid","title":"Canonical Article Id","type":"string"},"canonical_article_name":{"title":"Canonical Article Name","type":"string"},"carrier_code":{"title":"Carrier Code","type":"string"},"carrier_product_code":{"title":"Carrier Product Code","type":"string"},"carrier_product_configuration":{"additionalProperties":true,"title":"Carrier Product Configuration","type":"object"},"change_reason":{"title":"Change Reason","type":"string"},"created_at":{"format":"date-time","title":"Created At","type":"string"},"created_by":{"title":"Created By","type":"string"},"id":{"format":"uuid","title":"Id","type":"string"},"options":{"items":{"$ref":"#/components/schemas/ArticleOptionMappingAdminResponse"},"title":"Options","type":"array"},"restrictions":{"$ref":"#/components/schemas/ShipmentRestrictionsResponse"},"version":{"title":"Version","type":"integer"}},"required":["id","carrier_code","canonical_article_id","canonical_article_code","canonical_article_name","carrier_product_code","carrier_product_configuration","version","active","created_by","change_reason","created_at","options","restrictions"],"title":"PlatformArticleMappingAdminResponse","type":"object"},"ProblemDetail":{"additionalProperties":false,"properties":{"code":{"title":"Code","type":"string"},"correlation_id":{"title":"Correlation Id","type":"string"},"detail":{"title":"Detail","type":"string"},"errors":{"anyOf":[{"items":{"$ref":"#/components/schemas/ValidationIssue"},"type":"array"},{"type":"null"}],"title":"Errors"},"status":{"title":"Status","type":"integer"},"title":{"title":"Title","type":"string"},"type":{"title":"Type","type":"string"}},"required":["type","title","status","detail","code","correlation_id"],"title":"ProblemDetail","type":"object"},"ProposeMensaGlobalServicesRequest":{"additionalProperties":false,"properties":{"codes":{"items":{"type":"string"},"maxItems":100,"minItems":1,"title":"Codes","type":"array"}},"required":["codes"],"title":"ProposeMensaGlobalServicesRequest","type":"object"},"PublicCarrierCapabilityResponse":{"additionalProperties":false,"properties":{"code":{"title":"Code","type":"string"},"conditions":{"items":{"type":"string"},"title":"Conditions","type":"array"},"connector_status":{"title":"Connector Status","type":"string"},"enabled_environments":{"items":{"type":"string"},"title":"Enabled Environments","type":"array"},"provider_support":{"title":"Provider Support","type":"string"}},"required":["code","provider_support","connector_status","conditions","enabled_environments"],"title":"PublicCarrierCapabilityResponse","type":"object"},"PublicCarrierResponse":{"additionalProperties":false,"description":"Proyección pública y sanitizada de un adaptador registrado.","properties":{"availability":{"enum":["sandbox_available","certification_pending"],"title":"Availability","type":"string"},"capabilities":{"items":{"type":"string"},"title":"Capabilities","type":"array"},"code":{"title":"Code","type":"string"},"display_name":{"title":"Display Name","type":"string"},"extended_capabilities":{"items":{"$ref":"#/components/schemas/PublicCarrierCapabilityResponse"},"title":"Extended Capabilities","type":"array"}},"required":["code","display_name","availability","capabilities","extended_capabilities"],"title":"PublicCarrierResponse","type":"object"},"PudoPointResponse":{"additionalProperties":false,"properties":{"address_line1":{"title":"Address Line1","type":"string"},"city":{"title":"City","type":"string"},"country_code":{"title":"Country Code","type":"string"},"distance_km":{"anyOf":[{"pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$","type":"string"},{"type":"null"}],"title":"Distance Km"},"latitude":{"anyOf":[{"pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$","type":"string"},{"type":"null"}],"title":"Latitude"},"longitude":{"anyOf":[{"pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$","type":"string"},{"type":"null"}],"title":"Longitude"},"name":{"title":"Name","type":"string"},"point_type":{"title":"Point Type","type":"string"},"postal_code":{"title":"Postal Code","type":"string"},"provider_id":{"title":"Provider Id","type":"string"}},"required":["provider_id","name","point_type","address_line1","city","postal_code","country_code","latitude","longitude","distance_km"],"title":"PudoPointResponse","type":"object"},"PudoSearchResponse":{"additionalProperties":false,"properties":{"carrier_code":{"title":"Carrier Code","type":"string"},"points":{"items":{"$ref":"#/components/schemas/PudoPointResponse"},"title":"Points","type":"array"},"usage_conditions":{"items":{"type":"string"},"title":"Usage Conditions","type":"array"}},"required":["carrier_code","points","usage_conditions"],"title":"PudoSearchResponse","type":"object"},"RateLimitPolicyAdminResponse":{"additionalProperties":false,"properties":{"client_id":{"title":"Client Id","type":"string"},"requests_per_minute":{"title":"Requests Per Minute","type":"integer"},"shipment_creations_per_minute":{"title":"Shipment Creations Per Minute","type":"integer"},"updated_at":{"format":"date-time","title":"Updated At","type":"string"}},"required":["client_id","requests_per_minute","shipment_creations_per_minute","updated_at"],"title":"RateLimitPolicyAdminResponse","type":"object"},"RecipientRequest":{"additionalProperties":false,"properties":{"address_line1":{"maxLength":120,"minLength":1,"title":"Address Line1","type":"string"},"city":{"maxLength":120,"minLength":1,"title":"City","type":"string"},"contact_name":{"anyOf":[{"maxLength":120,"minLength":1,"type":"string"},{"type":"null"}],"title":"Contact Name"},"country_code":{"pattern":"^[A-Za-z]{2}$","title":"Country Code","type":"string"},"email":{"anyOf":[{"maxLength":254,"minLength":3,"type":"string"},{"type":"null"}],"title":"Email"},"latitude":{"anyOf":[{"maximum":90,"minimum":-90,"type":"number"},{"pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$","type":"string"},{"type":"null"}],"title":"Latitude"},"longitude":{"anyOf":[{"maximum":180,"minimum":-180,"type":"number"},{"pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$","type":"string"},{"type":"null"}],"title":"Longitude"},"name":{"maxLength":120,"minLength":1,"title":"Name","type":"string"},"phone":{"anyOf":[{"maxLength":30,"minLength":3,"type":"string"},{"type":"null"}],"title":"Phone"},"postal_code":{"maxLength":20,"minLength":1,"title":"Postal Code","type":"string"}},"required":["name","address_line1","city","postal_code","country_code"],"title":"RecipientRequest","type":"object"},"RecordConnectionServiceEntitlementRequest":{"additionalProperties":false,"properties":{"availability":{"enum":["contracted","not_contracted"],"title":"Availability","type":"string"},"carrier_product_code":{"maxLength":100,"minLength":1,"title":"Carrier Product Code","type":"string"},"change_reason":{"maxLength":1000,"minLength":1,"title":"Change Reason","type":"string"},"evidence_reference":{"maxLength":500,"minLength":1,"title":"Evidence Reference","type":"string"},"expires_at":{"format":"date-time","title":"Expires At","type":"string"},"source":{"enum":["customer_declaration","admin_review"],"title":"Source","type":"string"}},"required":["carrier_product_code","availability","source","evidence_reference","expires_at","change_reason"],"title":"RecordConnectionServiceEntitlementRequest","type":"object"},"RegisterMensaGlobalKeyRequest":{"additionalProperties":false,"properties":{"api_key":{"format":"password","maxLength":512,"minLength":8,"title":"Api Key","type":"string","writeOnly":true}},"required":["api_key"],"title":"RegisterMensaGlobalKeyRequest","type":"object"},"ReportIncidentRequest":{"additionalProperties":false,"properties":{"category":{"$ref":"#/components/schemas/IncidentCategory"},"customer_reference":{"anyOf":[{"maxLength":100,"minLength":1,"type":"string"},{"type":"null"}],"title":"Customer Reference"},"description":{"maxLength":1000,"minLength":1,"title":"Description","type":"string"}},"required":["category","description"],"title":"ReportIncidentRequest","type":"object"},"ResolveShipmentReconciliationRequest":{"additionalProperties":false,"properties":{"carrier_reference":{"anyOf":[{"maxLength":200,"minLength":1,"type":"string"},{"type":"null"}],"title":"Carrier Reference"},"decision":{"$ref":"#/components/schemas/ShipmentReconciliationDecision"},"evidence_reference":{"maxLength":500,"minLength":1,"title":"Evidence Reference","type":"string"},"expected_version":{"minimum":1,"title":"Expected Version","type":"integer"},"reason":{"maxLength":500,"minLength":3,"title":"Reason","type":"string"},"shipment_status":{"anyOf":[{"enum":["accepted","created"],"type":"string"},{"type":"null"}],"title":"Shipment Status"},"tracking_number":{"anyOf":[{"maxLength":200,"minLength":1,"type":"string"},{"type":"null"}],"title":"Tracking Number"}},"required":["expected_version","decision","reason","evidence_reference"],"title":"ResolveShipmentReconciliationRequest","type":"object"},"RetryOutboxMessageRequest":{"additionalProperties":false,"properties":{"evidence_reference":{"maxLength":500,"minLength":3,"title":"Evidence Reference","type":"string"},"expected_attempts":{"minimum":1,"title":"Expected Attempts","type":"integer"},"reason":{"maxLength":500,"minLength":3,"title":"Reason","type":"string"}},"required":["expected_attempts","reason","evidence_reference"],"title":"RetryOutboxMessageRequest","type":"object"},"ReverseLogisticsLabelResponse":{"additionalProperties":false,"properties":{"content_base64":{"title":"Content Base64","type":"string"},"format":{"title":"Format","type":"string"}},"required":["format","content_base64"],"title":"ReverseLogisticsLabelResponse","type":"object"},"ReverseLogisticsPolicyResponse":{"additionalProperties":false,"properties":{"available":{"title":"Available","type":"boolean"},"conditions":{"items":{"type":"string"},"title":"Conditions","type":"array"},"current_status":{"$ref":"#/components/schemas/ShipmentStatus"},"reason_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reason Code"},"shipment_id":{"format":"uuid","title":"Shipment Id","type":"string"}},"required":["shipment_id","available","current_status","reason_code","conditions"],"title":"ReverseLogisticsPolicyResponse","type":"object"},"ReverseLogisticsResponse":{"additionalProperties":false,"properties":{"article_code":{"title":"Article Code","type":"string"},"carrier_code":{"title":"Carrier Code","type":"string"},"carrier_connection_id":{"format":"uuid","title":"Carrier Connection Id","type":"string"},"carrier_pickup_reference":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Carrier Pickup Reference"},"carrier_return_shipment_reference":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Carrier Return Shipment Reference"},"created_at":{"format":"date-time","title":"Created At","type":"string"},"external_reference":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"External Reference"},"id":{"format":"uuid","title":"Id","type":"string"},"label":{"anyOf":[{"$ref":"#/components/schemas/ReverseLogisticsLabelResponse"},{"type":"null"}]},"original_shipment_id":{"format":"uuid","title":"Original Shipment Id","type":"string"},"pickup_date":{"format":"date","title":"Pickup Date","type":"string"},"pickup_reference":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Pickup Reference"},"pickup_window_from":{"title":"Pickup Window From","type":"string"},"pickup_window_to":{"title":"Pickup Window To","type":"string"},"return_shipment_reference":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Return Shipment Reference"}},"required":["id","original_shipment_id","carrier_connection_id","carrier_code","article_code","pickup_date","pickup_window_from","pickup_window_to","pickup_reference","carrier_pickup_reference","return_shipment_reference","carrier_return_shipment_reference","external_reference","label","created_at"],"title":"ReverseLogisticsResponse","type":"object"},"ServiceInfoResponse":{"additionalProperties":false,"properties":{"environment":{"title":"Environment","type":"string"},"name":{"title":"Name","type":"string"},"version":{"title":"Version","type":"string"}},"required":["name","version","environment"],"title":"ServiceInfoResponse","type":"object"},"SetRateLimitPolicyRequest":{"additionalProperties":false,"properties":{"requests_per_minute":{"maximum":100000,"minimum":1,"title":"Requests Per Minute","type":"integer"},"shipment_creations_per_minute":{"maximum":10000,"minimum":1,"title":"Shipment Creations Per Minute","type":"integer"}},"required":["requests_per_minute","shipment_creations_per_minute"],"title":"SetRateLimitPolicyRequest","type":"object"},"ShipmentModificationPolicyResponse":{"additionalProperties":false,"properties":{"allowed_statuses":{"items":{"$ref":"#/components/schemas/ShipmentStatus"},"title":"Allowed Statuses","type":"array"},"available":{"title":"Available","type":"boolean"},"conditions":{"items":{"type":"string"},"title":"Conditions","type":"array"},"current_status":{"$ref":"#/components/schemas/ShipmentStatus"},"editable_fields":{"items":{"type":"string"},"title":"Editable Fields","type":"array"},"reason_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reason Code"},"shipment_id":{"format":"uuid","title":"Shipment Id","type":"string"}},"required":["shipment_id","available","current_status","editable_fields","allowed_statuses","reason_code","conditions"],"title":"ShipmentModificationPolicyResponse","type":"object"},"ShipmentModificationResponse":{"additionalProperties":false,"properties":{"changed_fields":{"items":{"type":"string"},"title":"Changed Fields","type":"array"},"shipment_id":{"format":"uuid","title":"Shipment Id","type":"string"},"status":{"const":"applied","default":"applied","title":"Status","type":"string"}},"required":["shipment_id","changed_fields"],"title":"ShipmentModificationResponse","type":"object"},"ShipmentReconciliationAdminResponse":{"additionalProperties":false,"properties":{"attempts":{"title":"Attempts","type":"integer"},"available_at":{"format":"date-time","title":"Available At","type":"string"},"carrier_code":{"title":"Carrier Code","type":"string"},"carrier_connection_id":{"format":"uuid","title":"Carrier Connection Id","type":"string"},"carrier_environment":{"title":"Carrier Environment","type":"string"},"checkpoint_carrier_reference":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Checkpoint Carrier Reference"},"checkpoint_state":{"anyOf":[{"$ref":"#/components/schemas/CarrierCheckpointState"},{"type":"null"}]},"checkpoint_step":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Checkpoint Step"},"client_id":{"title":"Client Id","type":"string"},"created_at":{"format":"date-time","title":"Created At","type":"string"},"id":{"format":"uuid","title":"Id","type":"string"},"last_error_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Error Code"},"resolution_actor_id":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Resolution Actor Id"},"resolution_decision":{"anyOf":[{"$ref":"#/components/schemas/ShipmentReconciliationDecision"},{"type":"null"}]},"resolution_evidence_reference":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Resolution Evidence Reference"},"resolution_reason":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Resolution Reason"},"resolution_requested_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"title":"Resolution Requested At"},"resolved_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"title":"Resolved At"},"shipment_id":{"format":"uuid","title":"Shipment Id","type":"string"},"status":{"$ref":"#/components/schemas/ShipmentReconciliationStatus"},"updated_at":{"format":"date-time","title":"Updated At","type":"string"},"version":{"title":"Version","type":"integer"}},"required":["id","shipment_id","client_id","carrier_connection_id","carrier_code","carrier_environment","status","version","attempts","available_at","last_error_code","checkpoint_step","checkpoint_state","checkpoint_carrier_reference","resolution_decision","resolution_reason","resolution_evidence_reference","resolution_actor_id","resolution_requested_at","resolved_at","created_at","updated_at"],"title":"ShipmentReconciliationAdminResponse","type":"object"},"ShipmentReconciliationDecision":{"enum":["created","not_created"],"title":"ShipmentReconciliationDecision","type":"string"},"ShipmentReconciliationStatus":{"enum":["awaiting_result","pending","processing","manual_review","resolution_requested","resolved_created","resolved_not_created"],"title":"ShipmentReconciliationStatus","type":"string"},"ShipmentResponse":{"additionalProperties":false,"properties":{"article_code":{"title":"Article Code","type":"string"},"article_mapping_version":{"title":"Article Mapping Version","type":"integer"},"carrier_code":{"title":"Carrier Code","type":"string"},"carrier_connection_id":{"format":"uuid","title":"Carrier Connection Id","type":"string"},"carrier_reference":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Carrier Reference"},"created_at":{"format":"date-time","title":"Created At","type":"string"},"external_reference":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"External Reference"},"id":{"format":"uuid","title":"Id","type":"string"},"label":{"anyOf":[{"$ref":"#/components/schemas/LabelResponse"},{"type":"null"}]},"option_codes":{"items":{"type":"string"},"title":"Option Codes","type":"array"},"origin_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Origin Code"},"provider_attribution":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provider Attribution"},"pudo_point":{"anyOf":[{"$ref":"#/components/schemas/PudoPointResponse"},{"type":"null"}]},"status":{"$ref":"#/components/schemas/ShipmentStatus"},"tracking_data_expired":{"title":"Tracking Data Expired","type":"boolean"},"tracking_data_purge_due_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"title":"Tracking Data Purge Due At"},"tracking_data_purged_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"title":"Tracking Data Purged At"},"tracking_number":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Tracking Number"}},"required":["id","carrier_connection_id","carrier_code","carrier_reference","tracking_number","status","article_code","article_mapping_version","option_codes","origin_code","external_reference","label","created_at","provider_attribution","tracking_data_purge_due_at","tracking_data_purged_at","tracking_data_expired","pudo_point"],"title":"ShipmentResponse","type":"object"},"ShipmentRestrictionsRequest":{"additionalProperties":false,"properties":{"allowed_destination_country_codes":{"items":{"pattern":"^[A-Za-z]{2}$","type":"string"},"maxItems":250,"title":"Allowed Destination Country Codes","type":"array"},"allowed_origin_country_codes":{"items":{"pattern":"^[A-Za-z]{2}$","type":"string"},"maxItems":250,"title":"Allowed Origin Country Codes","type":"array"},"customs_declaration_required":{"default":false,"title":"Customs Declaration Required","type":"boolean"},"dimensions_required":{"default":false,"title":"Dimensions Required","type":"boolean"},"external_reference_required":{"default":false,"title":"External Reference Required","type":"boolean"},"max_height_cm":{"anyOf":[{"exclusiveMinimum":0,"maximum":100000,"type":"number"},{"pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$","type":"string"},{"type":"null"}],"title":"Max Height Cm"},"max_length_cm":{"anyOf":[{"exclusiveMinimum":0,"maximum":100000,"type":"number"},{"pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$","type":"string"},{"type":"null"}],"title":"Max Length Cm"},"max_package_weight_kg":{"anyOf":[{"exclusiveMinimum":0,"maximum":100000,"type":"number"},{"pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$","type":"string"},{"type":"null"}],"title":"Max Package Weight Kg"},"max_packages":{"default":100,"maximum":100,"minimum":1,"title":"Max Packages","type":"integer"},"max_total_weight_kg":{"anyOf":[{"exclusiveMinimum":0,"maximum":1000000,"type":"number"},{"pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$","type":"string"},{"type":"null"}],"title":"Max Total Weight Kg"},"max_width_cm":{"anyOf":[{"exclusiveMinimum":0,"maximum":100000,"type":"number"},{"pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$","type":"string"},{"type":"null"}],"title":"Max Width Cm"},"pudo_delivery_allowed":{"default":false,"title":"Pudo Delivery Allowed","type":"boolean"},"recipient_email_required":{"default":false,"title":"Recipient Email Required","type":"boolean"},"recipient_phone_required":{"default":false,"title":"Recipient Phone Required","type":"boolean"},"sender_email_required":{"default":false,"title":"Sender Email Required","type":"boolean"},"sender_phone_required":{"default":false,"title":"Sender Phone Required","type":"boolean"},"sender_required":{"default":false,"title":"Sender Required","type":"boolean"},"shipping_date_required":{"default":false,"title":"Shipping Date Required","type":"boolean"}},"title":"ShipmentRestrictionsRequest","type":"object"},"ShipmentRestrictionsResponse":{"additionalProperties":false,"properties":{"allowed_destination_country_codes":{"items":{"type":"string"},"title":"Allowed Destination Country Codes","type":"array"},"allowed_origin_country_codes":{"items":{"type":"string"},"title":"Allowed Origin Country Codes","type":"array"},"customs_declaration_required":{"title":"Customs Declaration Required","type":"boolean"},"dimensions_required":{"title":"Dimensions Required","type":"boolean"},"external_reference_required":{"title":"External Reference Required","type":"boolean"},"max_height_cm":{"anyOf":[{"pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$","type":"string"},{"type":"null"}],"title":"Max Height Cm"},"max_length_cm":{"anyOf":[{"pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$","type":"string"},{"type":"null"}],"title":"Max Length Cm"},"max_package_weight_kg":{"anyOf":[{"pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$","type":"string"},{"type":"null"}],"title":"Max Package Weight Kg"},"max_packages":{"title":"Max Packages","type":"integer"},"max_total_weight_kg":{"anyOf":[{"pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$","type":"string"},{"type":"null"}],"title":"Max Total Weight Kg"},"max_width_cm":{"anyOf":[{"pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$","type":"string"},{"type":"null"}],"title":"Max Width Cm"},"pudo_delivery_allowed":{"title":"Pudo Delivery Allowed","type":"boolean"},"recipient_email_required":{"title":"Recipient Email Required","type":"boolean"},"recipient_phone_required":{"title":"Recipient Phone Required","type":"boolean"},"sender_email_required":{"title":"Sender Email Required","type":"boolean"},"sender_phone_required":{"title":"Sender Phone Required","type":"boolean"},"sender_required":{"title":"Sender Required","type":"boolean"},"shipping_date_required":{"title":"Shipping Date Required","type":"boolean"}},"required":["allowed_origin_country_codes","allowed_destination_country_codes","max_packages","max_package_weight_kg","max_total_weight_kg","dimensions_required","max_length_cm","max_width_cm","max_height_cm","sender_required","shipping_date_required","external_reference_required","recipient_phone_required","recipient_email_required","sender_phone_required","sender_email_required","customs_declaration_required","pudo_delivery_allowed"],"title":"ShipmentRestrictionsResponse","type":"object"},"ShipmentStatus":{"enum":["accepted","created","in_transit","out_for_delivery","available_for_pickup","delivered","delivery_failed","exception","return_in_transit","returned","cancelled","unknown"],"title":"ShipmentStatus","type":"string"},"TrackingEventPageResponse":{"additionalProperties":false,"properties":{"items":{"items":{"$ref":"#/components/schemas/TrackingEventResponse"},"title":"Items","type":"array"},"next_cursor":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"title":"Next Cursor"},"provider_attribution":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provider Attribution"},"tracking_data_expired":{"title":"Tracking Data Expired","type":"boolean"},"tracking_data_purge_due_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"title":"Tracking Data Purge Due At"},"tracking_data_purged_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"title":"Tracking Data Purged At"}},"required":["items","next_cursor","provider_attribution","tracking_data_purge_due_at","tracking_data_purged_at","tracking_data_expired"],"title":"TrackingEventPageResponse","type":"object"},"TrackingEventResponse":{"additionalProperties":false,"properties":{"effective_at":{"format":"date-time","title":"Effective At","type":"string"},"id":{"format":"uuid","title":"Id","type":"string"},"location":{"anyOf":[{"$ref":"#/components/schemas/TrackingLocationResponse"},{"type":"null"}]},"provider_status_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provider Status Code"},"provider_status_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Provider Status Description"},"reason_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reason Code"},"reason_description":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Reason Description"},"received_at":{"format":"date-time","title":"Received At","type":"string"},"source":{"$ref":"#/components/schemas/TrackingEventSource"},"status":{"$ref":"#/components/schemas/ShipmentStatus"},"status_mapping_version":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Status Mapping Version"}},"required":["id","status","source","effective_at","received_at","provider_status_code","provider_status_description","location","reason_code","reason_description","status_mapping_version"],"title":"TrackingEventResponse","type":"object"},"TrackingEventSource":{"enum":["system","carrier_poll","carrier_webhook"],"title":"TrackingEventSource","type":"string"},"TrackingLocationResponse":{"additionalProperties":false,"properties":{"city":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"City"},"country_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Country Code"},"facility_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Facility Code"},"facility_name":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Facility Name"},"postal_code":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Postal Code"}},"required":["city","postal_code","country_code","facility_name","facility_code"],"title":"TrackingLocationResponse","type":"object"},"UpdateArticleMappingStatusRequest":{"additionalProperties":false,"properties":{"active":{"title":"Active","type":"boolean"}},"required":["active"],"title":"UpdateArticleMappingStatusRequest","type":"object"},"UpdateCanonicalArticleRequest":{"additionalProperties":false,"properties":{"active":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Active"},"description":{"anyOf":[{"maxLength":1000,"type":"string"},{"type":"null"}],"title":"Description"},"name":{"anyOf":[{"maxLength":200,"minLength":1,"type":"string"},{"type":"null"}],"title":"Name"}},"title":"UpdateCanonicalArticleRequest","type":"object"},"UpdateCanonicalOptionRequest":{"additionalProperties":false,"properties":{"active":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Active"},"description":{"anyOf":[{"maxLength":1000,"type":"string"},{"type":"null"}],"title":"Description"},"name":{"anyOf":[{"maxLength":200,"minLength":1,"type":"string"},{"type":"null"}],"title":"Name"}},"title":"UpdateCanonicalOptionRequest","type":"object"},"UpdateCarrierConnectionRequest":{"additionalProperties":false,"properties":{"credential_secret_ref":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"title":"Credential Secret Ref"},"display_name":{"anyOf":[{"maxLength":200,"minLength":1,"type":"string"},{"type":"null"}],"title":"Display Name"},"enabled_capabilities":{"anyOf":[{"items":{"maxLength":100,"minLength":1,"type":"string"},"maxItems":20,"type":"array","uniqueItems":true},{"type":"null"}],"title":"Enabled Capabilities"},"provider_application_id":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"title":"Provider Application Id"},"status":{"anyOf":[{"enum":["active","inactive"],"type":"string"},{"type":"null"}],"title":"Status"}},"title":"UpdateCarrierConnectionRequest","type":"object"},"UpdateCarrierProviderApplicationRequest":{"additionalProperties":false,"properties":{"application_secret_ref":{"anyOf":[{"maxLength":500,"type":"string"},{"type":"null"}],"title":"Application Secret Ref"},"auth_mode":{"anyOf":[{"$ref":"#/components/schemas/CarrierProviderApplicationAuthMode"},{"type":"null"}]},"name":{"anyOf":[{"maxLength":200,"minLength":1,"type":"string"},{"type":"null"}],"title":"Name"},"status":{"anyOf":[{"enum":["draft","disabled","active"],"type":"string"},{"type":"null"}],"title":"Status"}},"title":"UpdateCarrierProviderApplicationRequest","type":"object"},"UpdateCarrierStatusMappingRequest":{"additionalProperties":false,"properties":{"active":{"title":"Active","type":"boolean"}},"required":["active"],"title":"UpdateCarrierStatusMappingRequest","type":"object"},"UpdateClientRequest":{"additionalProperties":false,"properties":{"active":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Active"},"name":{"anyOf":[{"maxLength":200,"minLength":1,"type":"string"},{"type":"null"}],"title":"Name"}},"title":"UpdateClientRequest","type":"object"},"UpdateOriginMappingStatusRequest":{"additionalProperties":false,"properties":{"active":{"title":"Active","type":"boolean"}},"required":["active"],"title":"UpdateOriginMappingStatusRequest","type":"object"},"UpdateWebhookSubscriptionRequest":{"additionalProperties":false,"properties":{"active":{"anyOf":[{"type":"boolean"},{"type":"null"}],"title":"Active"},"event_types":{"anyOf":[{"items":{"type":"string"},"minItems":1,"type":"array","uniqueItems":true},{"type":"null"}],"title":"Event Types"},"expected_version":{"minimum":1,"title":"Expected Version","type":"integer"},"rotate_secret":{"default":false,"title":"Rotate Secret","type":"boolean"},"url":{"anyOf":[{"maxLength":2048,"minLength":1,"type":"string"},{"type":"null"}],"title":"Url"}},"required":["expected_version"],"title":"UpdateWebhookSubscriptionRequest","type":"object"},"ValidateCarrierConnectionRequest":{"additionalProperties":false,"properties":{"activate_on_success":{"default":false,"title":"Activate On Success","type":"boolean"},"probe_provider":{"default":true,"title":"Probe Provider","type":"boolean"}},"title":"ValidateCarrierConnectionRequest","type":"object"},"ValidateCarrierProductRequest":{"additionalProperties":false,"properties":{"carrier_connection_id":{"format":"uuid","title":"Carrier Connection Id","type":"string"},"carrier_product_code":{"maxLength":100,"minLength":1,"title":"Carrier Product Code","type":"string"},"carrier_product_configuration":{"additionalProperties":true,"maxProperties":50,"title":"Carrier Product Configuration","type":"object"}},"required":["carrier_connection_id","carrier_product_code"],"title":"ValidateCarrierProductRequest","type":"object"},"ValidationError":{"properties":{"ctx":{"title":"Context","type":"object"},"input":{"title":"Input"},"loc":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"title":"Location","type":"array"},"msg":{"title":"Message","type":"string"},"type":{"title":"Error Type","type":"string"}},"required":["loc","msg","type"],"title":"ValidationError","type":"object"},"ValidationIssue":{"additionalProperties":false,"properties":{"error_type":{"title":"Error Type","type":"string"},"location":{"items":{"anyOf":[{"type":"string"},{"type":"integer"}]},"title":"Location","type":"array"},"message":{"title":"Message","type":"string"}},"required":["location","message","error_type"],"title":"ValidationIssue","type":"object"},"WebhookDeliveryResponse":{"additionalProperties":false,"properties":{"attempts":{"title":"Attempts","type":"integer"},"available_at":{"format":"date-time","title":"Available At","type":"string"},"created_at":{"format":"date-time","title":"Created At","type":"string"},"delivered_at":{"anyOf":[{"format":"date-time","type":"string"},{"type":"null"}],"title":"Delivered At"},"event_type":{"title":"Event Type","type":"string"},"id":{"format":"uuid","title":"Id","type":"string"},"last_error":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"Last Error"},"response_status":{"anyOf":[{"type":"integer"},{"type":"null"}],"title":"Response Status"},"source_event_id":{"format":"uuid","title":"Source Event Id","type":"string"},"status":{"title":"Status","type":"string"},"subscription_id":{"format":"uuid","title":"Subscription Id","type":"string"}},"required":["id","subscription_id","source_event_id","event_type","status","attempts","response_status","last_error","available_at","created_at","delivered_at"],"title":"WebhookDeliveryResponse","type":"object"},"WebhookSubscriptionResponse":{"additionalProperties":false,"properties":{"active":{"title":"Active","type":"boolean"},"created_at":{"format":"date-time","title":"Created At","type":"string"},"event_types":{"items":{"type":"string"},"title":"Event Types","type":"array"},"id":{"format":"uuid","title":"Id","type":"string"},"updated_at":{"format":"date-time","title":"Updated At","type":"string"},"url":{"title":"Url","type":"string"},"version":{"title":"Version","type":"integer"}},"required":["id","url","event_types","active","version","created_at","updated_at"],"title":"WebhookSubscriptionResponse","type":"object"}},"securitySchemes":{"HTTPBearer":{"scheme":"bearer","type":"http"}}},"info":{"contact":{"name":"SendingBay"},"description":"API de SendingBay para clientes y productos internos. El consumidor usa artículos canónicos; las equivalencias y credenciales del transportista permanecen aisladas.","license":{"name":"Propietario"},"summary":"Contrato común para operar con múltiples transportistas","title":"Conector de Redes API","version":"0.1.0"},"openapi":"3.1.0","paths":{"/":{"get":{"operationId":"service_info__get","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ServiceInfoResponse"}}},"description":"Successful Response"}},"summary":"Identificar el servicio","tags":["health"]}},"/health/live":{"get":{"operationId":"liveness_health_live_get","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HealthResponse"}}},"description":"Successful Response"}},"summary":"Comprobar que el proceso está vivo","tags":["health"]}},"/health/ready":{"get":{"operationId":"readiness_health_ready_get","responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HealthResponse"}}},"description":"Successful Response"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"Service Unavailable"}},"summary":"Comprobar que el proceso está listo","tags":["health"]}},"/v1/admin/articles":{"get":{"operationId":"list_canonical_articles_v1_admin_articles_get","responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/CanonicalArticleAdminResponse"},"title":"Response List Canonical Articles V1 Admin Articles Get","type":"array"}}},"description":"Successful Response"}},"security":[{"HTTPBearer":[]}],"summary":"Listar el catálogo canónico de artículos","tags":["administration"]},"post":{"operationId":"create_canonical_article_v1_admin_articles_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateCanonicalArticleRequest"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CanonicalArticleAdminResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"HTTPBearer":[]}],"summary":"Crear un artículo canónico","tags":["administration"]}},"/v1/admin/articles/{article_id}":{"patch":{"operationId":"update_canonical_article_v1_admin_articles__article_id__patch","parameters":[{"in":"path","name":"article_id","required":true,"schema":{"format":"uuid","title":"Article Id","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateCanonicalArticleRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CanonicalArticleAdminResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"HTTPBearer":[]}],"summary":"Actualizar o desactivar un artículo canónico","tags":["administration"]}},"/v1/admin/audit-events":{"get":{"operationId":"list_audit_events_v1_admin_audit_events_get","parameters":[{"in":"query","name":"client_id","required":false,"schema":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"title":"Client Id"}},{"in":"query","name":"limit","required":false,"schema":{"default":100,"maximum":500,"minimum":1,"title":"Limit","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/AuditEventAdminResponse"},"title":"Response List Audit Events V1 Admin Audit Events Get","type":"array"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"HTTPBearer":[]}],"summary":"Consultar la auditoría administrativa","tags":["administration"]}},"/v1/admin/carrier-provider-applications":{"get":{"operationId":"list_carrier_provider_applications_v1_admin_carrier_provider_applications_get","parameters":[{"in":"query","name":"carrier_code","required":false,"schema":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"title":"Carrier Code"}},{"in":"query","name":"environment","required":false,"schema":{"anyOf":[{"maxLength":20,"type":"string"},{"type":"null"}],"title":"Environment"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/CarrierProviderApplicationAdminResponse"},"title":"Response List Carrier Provider Applications V1 Admin Carrier Provider Applications Get","type":"array"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"HTTPBearer":[]}],"summary":"Listar aplicaciones globales de transportistas","tags":["administration"]},"post":{"operationId":"create_carrier_provider_application_v1_admin_carrier_provider_applications_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateCarrierProviderApplicationRequest"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CarrierProviderApplicationAdminResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"HTTPBearer":[]}],"summary":"Registrar una aplicación global de transportista","tags":["administration"]}},"/v1/admin/carrier-provider-applications/{application_id}":{"patch":{"operationId":"update_carrier_provider_application_v1_admin_carrier_provider_applications__application_id__patch","parameters":[{"in":"path","name":"application_id","required":true,"schema":{"format":"uuid","title":"Application Id","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateCarrierProviderApplicationRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CarrierProviderApplicationAdminResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"HTTPBearer":[]}],"summary":"Actualizar una aplicación global sin activarla","tags":["administration"]}},"/v1/admin/carrier-provider-applications/{application_id}/change-plans":{"get":{"operationId":"list_carrier_provider_application_change_plans_v1_admin_carrier_provider_applications__application_id__change_plans_get","parameters":[{"in":"path","name":"application_id","required":true,"schema":{"format":"uuid","title":"Application Id","type":"string"}},{"in":"query","name":"limit","required":false,"schema":{"default":100,"maximum":200,"minimum":1,"title":"Limit","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/CarrierProviderApplicationChangePlanResponse"},"title":"Response List Carrier Provider Application Change Plans V1 Admin Carrier Provider Applications  Application Id  Change Plans Get","type":"array"}}},"description":"Successful Response"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"Not Found"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"HTTPBearer":[]}],"summary":"Listar los planes de cambio de una aplicación de transportista","tags":["administration"]},"post":{"operationId":"create_carrier_provider_application_change_plan_v1_admin_carrier_provider_applications__application_id__change_plans_post","parameters":[{"in":"path","name":"application_id","required":true,"schema":{"format":"uuid","title":"Application Id","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateCarrierProviderApplicationChangePlanRequest"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CarrierProviderApplicationChangePlanResponse"}}},"description":"Successful Response"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"Conflict"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"HTTPBearer":[]}],"summary":"Preparar un cambio de credencial global para revisión humana","tags":["administration"]}},"/v1/admin/carrier-provider-applications/{application_id}/change-plans/{plan_id}":{"get":{"operationId":"get_carrier_provider_application_change_plan_v1_admin_carrier_provider_applications__application_id__change_plans__plan_id__get","parameters":[{"in":"path","name":"application_id","required":true,"schema":{"format":"uuid","title":"Application Id","type":"string"}},{"in":"path","name":"plan_id","required":true,"schema":{"format":"uuid","title":"Plan Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CarrierProviderApplicationChangePlanResponse"}}},"description":"Successful Response"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"Not Found"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"HTTPBearer":[]}],"summary":"Consultar la evidencia congelada de un plan de cambio","tags":["administration"]}},"/v1/admin/carrier-provider-applications/{application_id}/change-plans/{plan_id}/cancel":{"post":{"operationId":"cancel_carrier_provider_application_change_plan_v1_admin_carrier_provider_applications__application_id__change_plans__plan_id__cancel_post","parameters":[{"in":"path","name":"application_id","required":true,"schema":{"format":"uuid","title":"Application Id","type":"string"}},{"in":"path","name":"plan_id","required":true,"schema":{"format":"uuid","title":"Plan Id","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CancelCarrierProviderApplicationChangePlanRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CarrierProviderApplicationChangePlanResponse"}}},"description":"Successful Response"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"Conflict"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"HTTPBearer":[]}],"summary":"Cancelar un plan pendiente conservando evidencia append-only","tags":["administration"]}},"/v1/admin/carrier-provider-applications/{application_id}/impact":{"get":{"operationId":"get_carrier_provider_application_impact_v1_admin_carrier_provider_applications__application_id__impact_get","parameters":[{"in":"path","name":"application_id","required":true,"schema":{"format":"uuid","title":"Application Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CarrierProviderApplicationImpactResponse"}}},"description":"Successful Response"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"Not Found"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"HTTPBearer":[]}],"summary":"Diagnosticar el impacto de una credencial global","tags":["administration"]}},"/v1/admin/carriers":{"get":{"operationId":"list_carriers_v1_admin_carriers_get","responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/CarrierAdapterAdminResponse"},"title":"Response List Carriers V1 Admin Carriers Get","type":"array"}}},"description":"Successful Response"}},"security":[{"HTTPBearer":[]}],"summary":"Listar transportistas y capacidades técnicas","tags":["administration"]}},"/v1/admin/carriers/{carrier_code}/article-mappings":{"get":{"operationId":"list_platform_article_mappings_v1_admin_carriers__carrier_code__article_mappings_get","parameters":[{"in":"path","name":"carrier_code","required":true,"schema":{"title":"Carrier Code","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/PlatformArticleMappingAdminResponse"},"title":"Response List Platform Article Mappings V1 Admin Carriers  Carrier Code  Article Mappings Get","type":"array"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"HTTPBearer":[]}],"summary":"Listar versiones de correspondencias globales de una plataforma","tags":["administration"]},"post":{"operationId":"create_platform_article_mapping_v1_admin_carriers__carrier_code__article_mappings_post","parameters":[{"in":"path","name":"carrier_code","required":true,"schema":{"title":"Carrier Code","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreatePlatformArticleMappingRequest"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformArticleMappingAdminResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"HTTPBearer":[]}],"summary":"Crear una versión global de correspondencia para una plataforma","tags":["administration"]}},"/v1/admin/carriers/{carrier_code}/article-mappings/{mapping_id}/status":{"patch":{"operationId":"update_platform_article_mapping_status_v1_admin_carriers__carrier_code__article_mappings__mapping_id__status_patch","parameters":[{"in":"path","name":"carrier_code","required":true,"schema":{"title":"Carrier Code","type":"string"}},{"in":"path","name":"mapping_id","required":true,"schema":{"format":"uuid","title":"Mapping Id","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateArticleMappingStatusRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PlatformArticleMappingAdminResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"HTTPBearer":[]}],"summary":"Activar o desactivar una versión global de correspondencia","tags":["administration"]}},"/v1/admin/carriers/{carrier_code}/status-mappings":{"get":{"operationId":"list_carrier_status_mappings_v1_admin_carriers__carrier_code__status_mappings_get","parameters":[{"in":"path","name":"carrier_code","required":true,"schema":{"title":"Carrier Code","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/CarrierStatusMappingAdminResponse"},"title":"Response List Carrier Status Mappings V1 Admin Carriers  Carrier Code  Status Mappings Get","type":"array"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"HTTPBearer":[]}],"summary":"Listar correspondencias de estados de un transportista","tags":["administration"]},"post":{"operationId":"create_carrier_status_mapping_v1_admin_carriers__carrier_code__status_mappings_post","parameters":[{"in":"path","name":"carrier_code","required":true,"schema":{"title":"Carrier Code","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateCarrierStatusMappingRequest"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CarrierStatusMappingAdminResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"HTTPBearer":[]}],"summary":"Crear una versión de correspondencia de estado","tags":["administration"]}},"/v1/admin/carriers/{carrier_code}/status-mappings/{mapping_id}/status":{"patch":{"operationId":"update_carrier_status_mapping_v1_admin_carriers__carrier_code__status_mappings__mapping_id__status_patch","parameters":[{"in":"path","name":"carrier_code","required":true,"schema":{"title":"Carrier Code","type":"string"}},{"in":"path","name":"mapping_id","required":true,"schema":{"format":"uuid","title":"Mapping Id","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateCarrierStatusMappingRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CarrierStatusMappingAdminResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"HTTPBearer":[]}],"summary":"Activar o desactivar una correspondencia de estado","tags":["administration"]}},"/v1/admin/clients":{"get":{"operationId":"list_clients_v1_admin_clients_get","responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/ClientAdminResponse"},"title":"Response List Clients V1 Admin Clients Get","type":"array"}}},"description":"Successful Response"}},"security":[{"HTTPBearer":[]}],"summary":"Listar clientes administrados","tags":["administration"]},"post":{"operationId":"create_client_v1_admin_clients_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateClientRequest"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientAdminResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"HTTPBearer":[]}],"summary":"Crear un cliente","tags":["administration"]}},"/v1/admin/clients/{client_id}":{"patch":{"operationId":"update_client_v1_admin_clients__client_id__patch","parameters":[{"in":"path","name":"client_id","required":true,"schema":{"title":"Client Id","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateClientRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ClientAdminResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"HTTPBearer":[]}],"summary":"Actualizar o desactivar un cliente","tags":["administration"]}},"/v1/admin/clients/{client_id}/api-credentials":{"get":{"operationId":"list_api_credentials_v1_admin_clients__client_id__api_credentials_get","parameters":[{"in":"path","name":"client_id","required":true,"schema":{"title":"Client Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/ApiCredentialAdminResponse"},"title":"Response List Api Credentials V1 Admin Clients  Client Id  Api Credentials Get","type":"array"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"HTTPBearer":[]}],"summary":"Listar credenciales técnicas sin revelar secretos","tags":["administration"]},"post":{"operationId":"issue_api_credential_v1_admin_clients__client_id__api_credentials_post","parameters":[{"in":"path","name":"client_id","required":true,"schema":{"title":"Client Id","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IssueApiCredentialRequest"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IssuedApiCredentialResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"HTTPBearer":[]}],"summary":"Emitir o rotar una credencial técnica","tags":["administration"]}},"/v1/admin/clients/{client_id}/api-credentials/{credential_id}/revoke":{"post":{"operationId":"revoke_api_credential_v1_admin_clients__client_id__api_credentials__credential_id__revoke_post","parameters":[{"in":"path","name":"client_id","required":true,"schema":{"title":"Client Id","type":"string"}},{"in":"path","name":"credential_id","required":true,"schema":{"format":"uuid","title":"Credential Id","type":"string"}}],"responses":{"204":{"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"HTTPBearer":[]}],"summary":"Revocar una credencial técnica","tags":["administration"]}},"/v1/admin/clients/{client_id}/article-mappings":{"get":{"operationId":"list_article_mappings_v1_admin_clients__client_id__article_mappings_get","parameters":[{"in":"path","name":"client_id","required":true,"schema":{"title":"Client Id","type":"string"}},{"in":"query","name":"carrier_connection_id","required":false,"schema":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"title":"Carrier Connection Id"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/ArticleMappingAdminResponse"},"title":"Response List Article Mappings V1 Admin Clients  Client Id  Article Mappings Get","type":"array"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"HTTPBearer":[]}],"summary":"Listar versiones de correspondencias de artículos","tags":["administration"]},"post":{"operationId":"create_article_mapping_version_v1_admin_clients__client_id__article_mappings_post","parameters":[{"in":"path","name":"client_id","required":true,"schema":{"title":"Client Id","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateArticleMappingRequest"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ArticleMappingAdminResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"HTTPBearer":[]}],"summary":"Crear una nueva versión de correspondencia","tags":["administration"]}},"/v1/admin/clients/{client_id}/article-mappings/validate-product":{"post":{"operationId":"validate_carrier_product_v1_admin_clients__client_id__article_mappings_validate_product_post","parameters":[{"in":"path","name":"client_id","required":true,"schema":{"title":"Client Id","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidateCarrierProductRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CarrierProductValidationResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"HTTPBearer":[]}],"summary":"Prevalidar un producto y su configuración técnica","tags":["administration"]}},"/v1/admin/clients/{client_id}/article-mappings/{mapping_id}/status":{"patch":{"operationId":"update_article_mapping_status_v1_admin_clients__client_id__article_mappings__mapping_id__status_patch","parameters":[{"in":"path","name":"client_id","required":true,"schema":{"title":"Client Id","type":"string"}},{"in":"path","name":"mapping_id","required":true,"schema":{"format":"uuid","title":"Mapping Id","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateArticleMappingStatusRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ArticleMappingAdminResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"HTTPBearer":[]}],"summary":"Activar o desactivar una versión de correspondencia","tags":["administration"]}},"/v1/admin/clients/{client_id}/carrier-connections":{"get":{"operationId":"list_connections_v1_admin_clients__client_id__carrier_connections_get","parameters":[{"in":"path","name":"client_id","required":true,"schema":{"title":"Client Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/CarrierConnectionAdminResponse"},"title":"Response List Connections V1 Admin Clients  Client Id  Carrier Connections Get","type":"array"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"HTTPBearer":[]}],"summary":"Listar conexiones de un cliente","tags":["administration"]},"post":{"operationId":"create_connection_v1_admin_clients__client_id__carrier_connections_post","parameters":[{"in":"path","name":"client_id","required":true,"schema":{"title":"Client Id","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateCarrierConnectionRequest"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CarrierConnectionAdminResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"HTTPBearer":[]}],"summary":"Crear una conexión de transportista","tags":["administration"]}},"/v1/admin/clients/{client_id}/carrier-connections/{connection_id}":{"patch":{"operationId":"update_connection_v1_admin_clients__client_id__carrier_connections__connection_id__patch","parameters":[{"in":"path","name":"client_id","required":true,"schema":{"title":"Client Id","type":"string"}},{"in":"path","name":"connection_id","required":true,"schema":{"format":"uuid","title":"Connection Id","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateCarrierConnectionRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CarrierConnectionAdminResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"HTTPBearer":[]}],"summary":"Configurar o cambiar el estado de una conexión","tags":["administration"]}},"/v1/admin/clients/{client_id}/carrier-connections/{connection_id}/service-entitlements":{"get":{"operationId":"list_connection_service_entitlements_v1_admin_clients__client_id__carrier_connections__connection_id__service_entitlements_get","parameters":[{"in":"path","name":"client_id","required":true,"schema":{"title":"Client Id","type":"string"}},{"in":"path","name":"connection_id","required":true,"schema":{"format":"uuid","title":"Connection Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/ConnectionServiceEntitlementAdminResponse"},"title":"Response List Connection Service Entitlements V1 Admin Clients  Client Id  Carrier Connections  Connection Id  Service Entitlements Get","type":"array"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"HTTPBearer":[]}],"summary":"Listar evidencia contractual por conexión y código de producto","tags":["administration"]},"post":{"operationId":"record_connection_service_entitlement_v1_admin_clients__client_id__carrier_connections__connection_id__service_entitlements_post","parameters":[{"in":"path","name":"client_id","required":true,"schema":{"title":"Client Id","type":"string"}},{"in":"path","name":"connection_id","required":true,"schema":{"format":"uuid","title":"Connection Id","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RecordConnectionServiceEntitlementRequest"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConnectionServiceEntitlementAdminResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"HTTPBearer":[]}],"summary":"Registrar una versión de evidencia contractual sin alterar el mapping global","tags":["administration"]}},"/v1/admin/clients/{client_id}/carrier-connections/{connection_id}/service-proposals":{"get":{"operationId":"list_connection_service_proposals_v1_admin_clients__client_id__carrier_connections__connection_id__service_proposals_get","parameters":[{"in":"path","name":"client_id","required":true,"schema":{"title":"Client Id","type":"string"}},{"in":"path","name":"connection_id","required":true,"schema":{"format":"uuid","title":"Connection Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/CarrierServiceProposalResponse"},"title":"Response List Connection Service Proposals V1 Admin Clients  Client Id  Carrier Connections  Connection Id  Service Proposals Get","type":"array"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"HTTPBearer":[]}],"summary":"Consultar listas de servicios declaradas por el cliente","tags":["administration"]}},"/v1/admin/clients/{client_id}/carrier-connections/{connection_id}/services":{"get":{"operationId":"list_connection_services_v1_admin_clients__client_id__carrier_connections__connection_id__services_get","parameters":[{"in":"path","name":"client_id","required":true,"schema":{"title":"Client Id","type":"string"}},{"in":"path","name":"connection_id","required":true,"schema":{"format":"uuid","title":"Connection Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/ConnectionServiceAdminResponse"},"title":"Response List Connection Services V1 Admin Clients  Client Id  Carrier Connections  Connection Id  Services Get","type":"array"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"HTTPBearer":[]}],"summary":"Listar versiones de servicios de una conexión","tags":["administration"]},"post":{"operationId":"create_connection_service_version_v1_admin_clients__client_id__carrier_connections__connection_id__services_post","parameters":[{"in":"path","name":"client_id","required":true,"schema":{"title":"Client Id","type":"string"}},{"in":"path","name":"connection_id","required":true,"schema":{"format":"uuid","title":"Connection Id","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateConnectionServiceRequest"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ConnectionServiceAdminResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"HTTPBearer":[]}],"summary":"Registrar una nueva versión del servicio contratado","tags":["administration"]}},"/v1/admin/clients/{client_id}/carrier-connections/{connection_id}/services/discovery":{"post":{"description":"No guarda ni activa servicios. 'contracted' sólo se devuelve cuando el adaptador puede confirmar el catálogo de esta conexión; 'reference' no acredita contratación.","operationId":"discover_connection_services_v1_admin_clients__client_id__carrier_connections__connection_id__services_discovery_post","parameters":[{"in":"path","name":"client_id","required":true,"schema":{"title":"Client Id","type":"string"}},{"in":"path","name":"connection_id","required":true,"schema":{"format":"uuid","title":"Connection Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CarrierServiceDiscoveryResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"HTTPBearer":[]}],"summary":"Consultar servicios informativos del transportista para esta conexión","tags":["administration"]}},"/v1/admin/clients/{client_id}/carrier-connections/{connection_id}/validate":{"post":{"operationId":"validate_connection_v1_admin_clients__client_id__carrier_connections__connection_id__validate_post","parameters":[{"in":"path","name":"client_id","required":true,"schema":{"title":"Client Id","type":"string"}},{"in":"path","name":"connection_id","required":true,"schema":{"format":"uuid","title":"Connection Id","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ValidateCarrierConnectionRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CarrierConnectionValidationResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"HTTPBearer":[]}],"summary":"Validar y, opcionalmente, activar una conexión","tags":["administration"]}},"/v1/admin/clients/{client_id}/origin-mappings":{"get":{"operationId":"list_origin_mappings_v1_admin_clients__client_id__origin_mappings_get","parameters":[{"in":"path","name":"client_id","required":true,"schema":{"title":"Client Id","type":"string"}},{"in":"query","name":"carrier_connection_id","required":false,"schema":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"title":"Carrier Connection Id"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/OriginMappingAdminResponse"},"title":"Response List Origin Mappings V1 Admin Clients  Client Id  Origin Mappings Get","type":"array"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"HTTPBearer":[]}],"summary":"Listar versiones de correspondencias técnicas de origen","tags":["administration"]},"post":{"operationId":"create_origin_mapping_version_v1_admin_clients__client_id__origin_mappings_post","parameters":[{"in":"path","name":"client_id","required":true,"schema":{"title":"Client Id","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateOriginMappingRequest"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OriginMappingAdminResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"HTTPBearer":[]}],"summary":"Crear una versión de correspondencia técnica de origen","tags":["administration"]}},"/v1/admin/clients/{client_id}/origin-mappings/{mapping_id}/status":{"patch":{"operationId":"update_origin_mapping_status_v1_admin_clients__client_id__origin_mappings__mapping_id__status_patch","parameters":[{"in":"path","name":"client_id","required":true,"schema":{"title":"Client Id","type":"string"}},{"in":"path","name":"mapping_id","required":true,"schema":{"format":"uuid","title":"Mapping Id","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateOriginMappingStatusRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OriginMappingAdminResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"HTTPBearer":[]}],"summary":"Activar o desactivar una versión de origen","tags":["administration"]}},"/v1/admin/clients/{client_id}/rate-limit-policy":{"get":{"operationId":"get_rate_limit_policy_v1_admin_clients__client_id__rate_limit_policy_get","parameters":[{"in":"path","name":"client_id","required":true,"schema":{"title":"Client Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/RateLimitPolicyAdminResponse"},{"type":"null"}],"title":"Response Get Rate Limit Policy V1 Admin Clients  Client Id  Rate Limit Policy Get"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"HTTPBearer":[]}],"summary":"Consultar la cuota particular de un cliente","tags":["administration"]},"put":{"operationId":"set_rate_limit_policy_v1_admin_clients__client_id__rate_limit_policy_put","parameters":[{"in":"path","name":"client_id","required":true,"schema":{"title":"Client Id","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/SetRateLimitPolicyRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RateLimitPolicyAdminResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"HTTPBearer":[]}],"summary":"Configurar la cuota particular de un cliente","tags":["administration"]}},"/v1/admin/clients/{client_id}/shipments/{shipment_id}/incidents":{"get":{"operationId":"list_client_shipment_incidents_v1_admin_clients__client_id__shipments__shipment_id__incidents_get","parameters":[{"in":"path","name":"client_id","required":true,"schema":{"title":"Client Id","type":"string"}},{"in":"path","name":"shipment_id","required":true,"schema":{"format":"uuid","title":"Shipment Id","type":"string"}},{"in":"query","name":"cursor","required":false,"schema":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"title":"Cursor"}},{"in":"query","name":"limit","required":false,"schema":{"default":100,"maximum":200,"minimum":1,"title":"Limit","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IncidentPageResponse"}}},"description":"Successful Response"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"Not Found"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"Unprocessable Entity"}},"security":[{"HTTPBearer":[]}],"summary":"Listar incidencias de un envío para soporte interno","tags":["administration"]}},"/v1/admin/clients/{client_id}/webhook-deliveries":{"get":{"operationId":"list_client_webhook_deliveries_v1_admin_clients__client_id__webhook_deliveries_get","parameters":[{"in":"path","name":"client_id","required":true,"schema":{"title":"Client Id","type":"string"}},{"in":"query","name":"subscription_id","required":false,"schema":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"title":"Subscription Id"}},{"in":"query","name":"limit","required":false,"schema":{"default":100,"maximum":200,"minimum":1,"title":"Limit","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/WebhookDeliveryResponse"},"title":"Response List Client Webhook Deliveries V1 Admin Clients  Client Id  Webhook Deliveries Get","type":"array"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"HTTPBearer":[]}],"summary":"Consultar entregas webhook de un cliente","tags":["administration"]}},"/v1/admin/clients/{client_id}/webhook-deliveries/{delivery_id}/retry":{"post":{"operationId":"retry_client_webhook_delivery_v1_admin_clients__client_id__webhook_deliveries__delivery_id__retry_post","parameters":[{"in":"path","name":"client_id","required":true,"schema":{"title":"Client Id","type":"string"}},{"in":"path","name":"delivery_id","required":true,"schema":{"format":"uuid","title":"Delivery Id","type":"string"}}],"responses":{"202":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookDeliveryResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"HTTPBearer":[]}],"summary":"Reintentar una entrega webhook en dead_letter","tags":["administration"]}},"/v1/admin/clients/{client_id}/webhook-subscriptions":{"get":{"operationId":"list_client_webhook_subscriptions_v1_admin_clients__client_id__webhook_subscriptions_get","parameters":[{"in":"path","name":"client_id","required":true,"schema":{"title":"Client Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/WebhookSubscriptionResponse"},"title":"Response List Client Webhook Subscriptions V1 Admin Clients  Client Id  Webhook Subscriptions Get","type":"array"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"HTTPBearer":[]}],"summary":"Consultar suscripciones webhook de un cliente","tags":["administration"]}},"/v1/admin/operations/carriers":{"get":{"operationId":"list_carrier_operational_diagnostics_v1_admin_operations_carriers_get","parameters":[{"in":"query","name":"carrier_code","required":false,"schema":{"anyOf":[{"maxLength":50,"minLength":1,"type":"string"},{"type":"null"}],"title":"Carrier Code"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/CarrierOperationalDiagnosticResponse"},"title":"Response List Carrier Operational Diagnostics V1 Admin Operations Carriers Get","type":"array"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"HTTPBearer":[]}],"summary":"Consultar el estado operativo de los transportistas","tags":["administration"]}},"/v1/admin/operations/outbox":{"get":{"operationId":"list_outbox_messages_v1_admin_operations_outbox_get","parameters":[{"in":"query","name":"client_id","required":false,"schema":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"title":"Client Id"}},{"in":"query","name":"outbox_status","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/OutboxStatus"},{"type":"null"}],"title":"Outbox Status"}},{"in":"query","name":"topic","required":false,"schema":{"anyOf":[{"maxLength":100,"minLength":1,"type":"string"},{"type":"null"}],"title":"Topic"}},{"in":"query","name":"limit","required":false,"schema":{"default":100,"maximum":500,"minimum":1,"title":"Limit","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/OutboxMessageAdminResponse"},"title":"Response List Outbox Messages V1 Admin Operations Outbox Get","type":"array"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"HTTPBearer":[]}],"summary":"Diagnosticar mensajes de outbox","tags":["administration"]}},"/v1/admin/operations/outbox/{message_id}/retry":{"post":{"operationId":"retry_outbox_message_v1_admin_operations_outbox__message_id__retry_post","parameters":[{"in":"path","name":"message_id","required":true,"schema":{"format":"uuid","title":"Message Id","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RetryOutboxMessageRequest"}}},"required":true},"responses":{"202":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/OutboxMessageAdminResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"HTTPBearer":[]}],"summary":"Reencolar un mensaje de outbox agotado","tags":["administration"]}},"/v1/admin/operations/shipment-reconciliations":{"get":{"operationId":"list_shipment_reconciliations_v1_admin_operations_shipment_reconciliations_get","parameters":[{"in":"query","name":"client_id","required":false,"schema":{"anyOf":[{"maxLength":100,"type":"string"},{"type":"null"}],"title":"Client Id"}},{"in":"query","name":"reconciliation_status","required":false,"schema":{"anyOf":[{"$ref":"#/components/schemas/ShipmentReconciliationStatus"},{"type":"null"}],"title":"Reconciliation Status"}},{"in":"query","name":"limit","required":false,"schema":{"default":100,"maximum":500,"minimum":1,"title":"Limit","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/ShipmentReconciliationAdminResponse"},"title":"Response List Shipment Reconciliations V1 Admin Operations Shipment Reconciliations Get","type":"array"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"HTTPBearer":[]}],"summary":"Listar altas de envío pendientes de conciliación","tags":["administration"]}},"/v1/admin/operations/shipment-reconciliations/{case_id}/resolution":{"post":{"operationId":"resolve_shipment_reconciliation_v1_admin_operations_shipment_reconciliations__case_id__resolution_post","parameters":[{"in":"path","name":"case_id","required":true,"schema":{"format":"uuid","title":"Case Id","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ResolveShipmentReconciliationRequest"}}},"required":true},"responses":{"202":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShipmentReconciliationAdminResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"HTTPBearer":[]}],"summary":"Solicitar la resolución de un alta incierta","tags":["administration"]}},"/v1/admin/options":{"get":{"operationId":"list_canonical_options_v1_admin_options_get","responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/CanonicalOptionAdminResponse"},"title":"Response List Canonical Options V1 Admin Options Get","type":"array"}}},"description":"Successful Response"}},"security":[{"HTTPBearer":[]}],"summary":"Listar el catálogo canónico de opciones","tags":["administration"]},"post":{"operationId":"create_canonical_option_v1_admin_options_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateCanonicalOptionRequest"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CanonicalOptionAdminResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"HTTPBearer":[]}],"summary":"Crear una opción canónica","tags":["administration"]}},"/v1/admin/options/{option_id}":{"patch":{"operationId":"update_canonical_option_v1_admin_options__option_id__patch","parameters":[{"in":"path","name":"option_id","required":true,"schema":{"format":"uuid","title":"Option Id","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateCanonicalOptionRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CanonicalOptionAdminResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"HTTPBearer":[]}],"summary":"Actualizar o desactivar una opción canónica","tags":["administration"]}},"/v1/articles":{"get":{"operationId":"list_articles_v1_articles_get","responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/ArticleResponse"},"title":"Response List Articles V1 Articles Get","type":"array"}}},"description":"Successful Response"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"Forbidden"}},"security":[{"HTTPBearer":[]}],"summary":"Listar artículos canónicos disponibles","tags":["catalog"]}},"/v1/carrier-connections":{"get":{"operationId":"list_connections_v1_carrier_connections_get","responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/ConnectionResponse"},"title":"Response List Connections V1 Carrier Connections Get","type":"array"}}},"description":"Successful Response"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"Forbidden"}},"security":[{"HTTPBearer":[]}],"summary":"Listar conexiones disponibles","tags":["catalog"]}},"/v1/carrier-connections/{connection_id}/articles":{"get":{"operationId":"list_connection_articles_v1_carrier_connections__connection_id__articles_get","parameters":[{"in":"path","name":"connection_id","required":true,"schema":{"format":"uuid","title":"Connection Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/ConnectionArticleResponse"},"title":"Response List Connection Articles V1 Carrier Connections  Connection Id  Articles Get","type":"array"}}},"description":"Successful Response"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"Not Found"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"HTTPBearer":[]}],"summary":"Listar artículos y restricciones de una conexión","tags":["catalog"]}},"/v1/carrier-connections/{connection_id}/credentials/mensaglobal":{"put":{"description":"La clave se escribe en Secret Manager y nunca se devuelve. Una rotación desactiva la conexión hasta que el titular vuelva a declarar sus servicios. Requiere scope exclusivo de gestión.","operationId":"register_mensaglobal_key_v1_carrier_connections__connection_id__credentials_mensaglobal_put","parameters":[{"in":"path","name":"connection_id","required":true,"schema":{"format":"uuid","title":"Connection Id","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/RegisterMensaGlobalKeyRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CarrierCredentialRegistrationResponse"}}},"description":"Successful Response"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"Conflict"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"Unprocessable Entity"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"Service Unavailable"}},"security":[{"HTTPBearer":[]}],"summary":"Registrar o rotar la API key de MensaGlobal de una conexión propia","tags":["carrier-credentials"]}},"/v1/carrier-connections/{connection_id}/origins":{"get":{"operationId":"list_connection_origins_v1_carrier_connections__connection_id__origins_get","parameters":[{"in":"path","name":"connection_id","required":true,"schema":{"format":"uuid","title":"Connection Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/ConnectionOriginResponse"},"title":"Response List Connection Origins V1 Carrier Connections  Connection Id  Origins Get","type":"array"}}},"description":"Successful Response"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"Not Found"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"HTTPBearer":[]}],"summary":"Listar códigos de origen configurados para una conexión","tags":["catalog"]}},"/v1/carrier-connections/{connection_id}/pudo-points":{"get":{"description":"Busca puntos PUDO mediante el contrato canónico. La respuesta incluye restricciones de uso que el cliente debe respetar y no garantiza compatibilidad con todos los artículos.","operationId":"search_pudo_points_v1_carrier_connections__connection_id__pudo_points_get","parameters":[{"in":"path","name":"connection_id","required":true,"schema":{"format":"uuid","title":"Connection Id","type":"string"}},{"in":"query","name":"country_code","required":true,"schema":{"pattern":"^[A-Za-z]{2}$","title":"Country Code","type":"string"}},{"in":"query","name":"postal_code","required":false,"schema":{"anyOf":[{"maxLength":20,"minLength":1,"type":"string"},{"type":"null"}],"title":"Postal Code"}},{"in":"query","name":"city","required":false,"schema":{"anyOf":[{"maxLength":120,"minLength":1,"type":"string"},{"type":"null"}],"title":"City"}},{"in":"query","name":"address_line1","required":false,"schema":{"anyOf":[{"maxLength":200,"minLength":1,"type":"string"},{"type":"null"}],"title":"Address Line1"}},{"in":"query","name":"latitude","required":false,"schema":{"anyOf":[{"maximum":90,"minimum":-90,"type":"number"},{"pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$","type":"string"},{"type":"null"}],"title":"Latitude"}},{"in":"query","name":"longitude","required":false,"schema":{"anyOf":[{"maximum":180,"minimum":-180,"type":"number"},{"pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$","type":"string"},{"type":"null"}],"title":"Longitude"}},{"in":"query","name":"radius_km","required":false,"schema":{"anyOf":[{"exclusiveMinimum":0,"maximum":50,"type":"number"},{"pattern":"^(?!^[-+.]*$)[+-]?0*\\d*\\.?\\d*$","type":"string"}],"default":"10","title":"Radius Km"}},{"in":"query","name":"limit","required":false,"schema":{"default":20,"maximum":25,"minimum":1,"title":"Limit","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/PudoSearchResponse"}}},"description":"Successful Response"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"Not Found"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"Unprocessable Entity"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"Service Unavailable"}},"security":[{"HTTPBearer":[]}],"summary":"Buscar puntos de entrega o recogida","tags":["locations"]}},"/v1/carrier-connections/{connection_id}/service-proposals":{"post":{"description":"Recibe la lista declarada por el titular, sustituye la lista permitida de la conexión y la activa si ya tiene API key. No aplica catálogo canónico ni aprobación de SendingBay.","operationId":"propose_mensaglobal_services_v1_carrier_connections__connection_id__service_proposals_post","parameters":[{"in":"path","name":"connection_id","required":true,"schema":{"format":"uuid","title":"Connection Id","type":"string"}},{"in":"header","name":"X-Idempotency-Key","required":true,"schema":{"title":"X-Idempotency-Key","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProposeMensaGlobalServicesRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CarrierServiceProposalResponse"}}},"description":"Successful Response"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"Conflict"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"Unprocessable Entity"}},"security":[{"HTTPBearer":[]}],"summary":"Declarar los códigos de servicio pactados para MensaGlobal","tags":["carrier-credentials"]}},"/v1/carriers":{"get":{"description":"Devuelve el catálogo público sanitizado de adaptadores reales. No expone credenciales, endpoints del proveedor ni configuración operativa interna.","operationId":"list_public_carriers_v1_carriers_get","responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/PublicCarrierResponse"},"title":"Response List Public Carriers V1 Carriers Get","type":"array"}}},"description":"Successful Response"}},"summary":"Listar transportistas integrados","tags":["catalog"]}},"/v1/integrations/ecomm/workspaces/{workspace_id}":{"get":{"description":"Devuelve el cliente y las conexiones MensaGlobal vinculadas, sin secretos. Sirve para reconciliar altas parciales y suspensiones desde el backend de Ecomm.","operationId":"get_workspace_state_v1_integrations_ecomm_workspaces__workspace_id__get","parameters":[{"in":"path","name":"workspace_id","required":true,"schema":{"exclusiveMinimum":0,"title":"Workspace Id","type":"integer"}},{"in":"header","name":"X-Ecomm-Api-Key","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Ecomm-Api-Key"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EcommWorkspaceStateResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Consultar el estado técnico de un workspace Ecomm","tags":["ecomm-integration"]}},"/v1/integrations/ecomm/workspaces/{workspace_id}/logistics-credentials/{external_issuance_id}":{"put":{"description":"La clave sólo permite crear envíos por conexiones MensaGlobal activas y vinculadas y consultar sus expediciones para recuperar etiquetas. Se entrega una vez; un UUID repetido devuelve 409 sin secreto y uno nuevo rota la clave.","operationId":"issue_logistics_credential_v1_integrations_ecomm_workspaces__workspace_id__logistics_credentials__external_issuance_id__put","parameters":[{"in":"path","name":"workspace_id","required":true,"schema":{"exclusiveMinimum":0,"title":"Workspace Id","type":"integer"}},{"in":"path","name":"external_issuance_id","required":true,"schema":{"format":"uuid","title":"External Issuance Id","type":"string"}},{"in":"header","name":"X-Ecomm-Api-Key","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Ecomm-Api-Key"}}],"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EcommCredentialResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Emitir o rotar la credencial logística MensaGlobal de un workspace","tags":["ecomm-integration"]}},"/v1/integrations/ecomm/workspaces/{workspace_id}/management-credentials/{external_issuance_id}":{"put":{"description":"La clave se devuelve sólo una vez. Repetir el mismo UUID responde 409 sin secreto; un UUID nuevo revoca la anterior y entrega otra clave. No concede permisos de envío.","operationId":"issue_management_credential_v1_integrations_ecomm_workspaces__workspace_id__management_credentials__external_issuance_id__put","parameters":[{"in":"path","name":"workspace_id","required":true,"schema":{"exclusiveMinimum":0,"title":"Workspace Id","type":"integer"}},{"in":"path","name":"external_issuance_id","required":true,"schema":{"format":"uuid","title":"External Issuance Id","type":"string"}},{"in":"header","name":"X-Ecomm-Api-Key","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Ecomm-Api-Key"}}],"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EcommCredentialResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Emitir o rotar la credencial de gestión MensaGlobal de un workspace","tags":["ecomm-integration"]}},"/v1/integrations/ecomm/workspaces/{workspace_id}/mensaglobal-connections/{external_integration_id}":{"put":{"description":"Sólo para el backend de Ecomm. Crea un cliente aislado y una conexión inactiva; no emite credenciales, no registra API keys de MensaGlobal y no habilita envíos.","operationId":"provision_connection_v1_integrations_ecomm_workspaces__workspace_id__mensaglobal_connections__external_integration_id__put","parameters":[{"in":"path","name":"workspace_id","required":true,"schema":{"exclusiveMinimum":0,"title":"Workspace Id","type":"integer"}},{"in":"path","name":"external_integration_id","required":true,"schema":{"format":"uuid","title":"External Integration Id","type":"string"}},{"in":"header","name":"X-Ecomm-Api-Key","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Ecomm-Api-Key"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EcommConnectionProvisionRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EcommConnectionProvisionResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Crear o recuperar la conexión MensaGlobal de un workspace Ecomm","tags":["ecomm-integration"]}},"/v1/integrations/ecomm/workspaces/{workspace_id}/status":{"put":{"description":"Operación idempotente: repetir el mismo estado no genera nuevos efectos. La suspensión revoca las claves de gestión y logística; la reactivación no las restaura.","operationId":"set_workspace_status_v1_integrations_ecomm_workspaces__workspace_id__status_put","parameters":[{"in":"path","name":"workspace_id","required":true,"schema":{"exclusiveMinimum":0,"title":"Workspace Id","type":"integer"}},{"in":"header","name":"X-Ecomm-Api-Key","required":false,"schema":{"anyOf":[{"type":"string"},{"type":"null"}],"title":"X-Ecomm-Api-Key"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EcommWorkspaceStatusRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/EcommWorkspaceStateResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"summary":"Suspender o reactivar el vínculo de un workspace Ecomm","tags":["ecomm-integration"]}},"/v1/shipments":{"post":{"operationId":"create_shipment_v1_shipments_post","parameters":[{"description":"Clave única por cliente y operación","in":"header","name":"Idempotency-Key","required":true,"schema":{"description":"Clave única por cliente y operación","maxLength":128,"minLength":8,"title":"Idempotency-Key","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateShipmentRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShipmentResponse"}}},"description":"Resultado idempotente reproducido"},"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShipmentResponse"}}},"description":"Successful Response"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"Conflict"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"Unprocessable Entity"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"Service Unavailable"}},"security":[{"HTTPBearer":[]}],"summary":"Crear un envío","tags":["shipments"]}},"/v1/shipments/{shipment_id}":{"get":{"operationId":"get_shipment_v1_shipments__shipment_id__get","parameters":[{"in":"path","name":"shipment_id","required":true,"schema":{"format":"uuid","title":"Shipment Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShipmentResponse"}}},"description":"Successful Response"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"Not Found"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"HTTPBearer":[]}],"summary":"Consultar un envío","tags":["shipments"]}},"/v1/shipments/{shipment_id}/incident-policy":{"get":{"operationId":"get_incident_reporting_policy_v1_shipments__shipment_id__incident_policy_get","parameters":[{"in":"path","name":"shipment_id","required":true,"schema":{"format":"uuid","title":"Shipment Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IncidentReportingPolicyResponse"}}},"description":"Successful Response"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"Not Found"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"HTTPBearer":[]}],"summary":"Consultar qué incidencias pueden reportarse para un envío","tags":["shipments"]}},"/v1/shipments/{shipment_id}/incidents":{"get":{"operationId":"list_incidents_v1_shipments__shipment_id__incidents_get","parameters":[{"in":"path","name":"shipment_id","required":true,"schema":{"format":"uuid","title":"Shipment Id","type":"string"}},{"description":"Último identificador recibido en la página anterior","in":"query","name":"cursor","required":false,"schema":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"description":"Último identificador recibido en la página anterior","title":"Cursor"}},{"in":"query","name":"limit","required":false,"schema":{"default":100,"maximum":200,"minimum":1,"title":"Limit","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IncidentPageResponse"}}},"description":"Successful Response"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"Not Found"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"Unprocessable Entity"}},"security":[{"HTTPBearer":[]}],"summary":"Listar las incidencias de un envío","tags":["shipments"]},"post":{"operationId":"report_incident_v1_shipments__shipment_id__incidents_post","parameters":[{"in":"path","name":"shipment_id","required":true,"schema":{"format":"uuid","title":"Shipment Id","type":"string"}},{"description":"Clave única por cliente, envío e incidencia","in":"header","name":"Idempotency-Key","required":true,"schema":{"description":"Clave única por cliente, envío e incidencia","maxLength":128,"minLength":8,"title":"Idempotency-Key","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReportIncidentRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IncidentReportResponse"}}},"description":"Resultado idempotente reproducido"},"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IncidentReportResponse"}}},"description":"Successful Response"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"Conflict"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"Unprocessable Entity"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"Service Unavailable"}},"security":[{"HTTPBearer":[]}],"summary":"Reportar una incidencia al transportista","tags":["shipments"]}},"/v1/shipments/{shipment_id}/incidents/{incident_id}":{"get":{"operationId":"get_incident_v1_shipments__shipment_id__incidents__incident_id__get","parameters":[{"in":"path","name":"shipment_id","required":true,"schema":{"format":"uuid","title":"Shipment Id","type":"string"}},{"in":"path","name":"incident_id","required":true,"schema":{"format":"uuid","title":"Incident Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IncidentResponse"}}},"description":"Successful Response"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"Not Found"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"HTTPBearer":[]}],"summary":"Consultar una incidencia de un envío","tags":["shipments"]}},"/v1/shipments/{shipment_id}/label-recovery":{"post":{"description":"Consulta y conserva la etiqueta sin volver a crear el envío. La operación es segura para reintentar y requiere shipments:read.","operationId":"recover_shipment_label_v1_shipments__shipment_id__label_recovery_post","parameters":[{"in":"path","name":"shipment_id","required":true,"schema":{"format":"uuid","title":"Shipment Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShipmentResponse"}}},"description":"Successful Response"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"Conflict"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"Unprocessable Entity"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"Service Unavailable"}},"security":[{"HTTPBearer":[]}],"summary":"Recuperar una etiqueta diferida","tags":["shipments"]}},"/v1/shipments/{shipment_id}/modification-policy":{"get":{"operationId":"get_shipment_modification_policy_v1_shipments__shipment_id__modification_policy_get","parameters":[{"in":"path","name":"shipment_id","required":true,"schema":{"format":"uuid","title":"Shipment Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShipmentModificationPolicyResponse"}}},"description":"Successful Response"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"Not Found"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"HTTPBearer":[]}],"summary":"Consultar qué puede modificarse en un envío","tags":["shipments"]}},"/v1/shipments/{shipment_id}/modifications":{"post":{"operationId":"modify_shipment_v1_shipments__shipment_id__modifications_post","parameters":[{"in":"path","name":"shipment_id","required":true,"schema":{"format":"uuid","title":"Shipment Id","type":"string"}},{"description":"Clave única por cliente, envío y modificación","in":"header","name":"Idempotency-Key","required":true,"schema":{"description":"Clave única por cliente, envío y modificación","maxLength":128,"minLength":8,"title":"Idempotency-Key","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ModifyShipmentRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShipmentModificationResponse"}}},"description":"Resultado idempotente reproducido"},"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ShipmentModificationResponse"}}},"description":"Successful Response"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"Conflict"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"Unprocessable Entity"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"Service Unavailable"}},"security":[{"HTTPBearer":[]}],"summary":"Modificar campos admitidos de un envío","tags":["shipments"]}},"/v1/shipments/{shipment_id}/reverse-logistics":{"get":{"operationId":"list_reverse_logistics_v1_shipments__shipment_id__reverse_logistics_get","parameters":[{"in":"path","name":"shipment_id","required":true,"schema":{"format":"uuid","title":"Shipment Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/ReverseLogisticsResponse"},"title":"Response List Reverse Logistics V1 Shipments  Shipment Id  Reverse Logistics Get","type":"array"}}},"description":"Successful Response"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"Not Found"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"HTTPBearer":[]}],"summary":"Listar las operaciones de logística inversa de un envío","tags":["shipments"]},"post":{"operationId":"create_reverse_logistics_v1_shipments__shipment_id__reverse_logistics_post","parameters":[{"in":"path","name":"shipment_id","required":true,"schema":{"format":"uuid","title":"Shipment Id","type":"string"}},{"description":"Clave única por cliente, envío y devolución","in":"header","name":"Idempotency-Key","required":true,"schema":{"description":"Clave única por cliente, envío y devolución","maxLength":128,"minLength":8,"title":"Idempotency-Key","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateReverseLogisticsRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReverseLogisticsResponse"}}},"description":"Resultado idempotente reproducido"},"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReverseLogisticsResponse"}}},"description":"Successful Response"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"Not Found"},"409":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"Conflict"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"Unprocessable Entity"},"503":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"Service Unavailable"}},"security":[{"HTTPBearer":[]}],"summary":"Crear una operación de logística inversa","tags":["shipments"]}},"/v1/shipments/{shipment_id}/reverse-logistics-policy":{"get":{"operationId":"get_reverse_logistics_policy_v1_shipments__shipment_id__reverse_logistics_policy_get","parameters":[{"in":"path","name":"shipment_id","required":true,"schema":{"format":"uuid","title":"Shipment Id","type":"string"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ReverseLogisticsPolicyResponse"}}},"description":"Successful Response"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"Not Found"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"HTTPBearer":[]}],"summary":"Consultar la disponibilidad de logística inversa","tags":["shipments"]}},"/v1/shipments/{shipment_id}/tracking-events":{"get":{"operationId":"list_tracking_events_v1_shipments__shipment_id__tracking_events_get","parameters":[{"in":"path","name":"shipment_id","required":true,"schema":{"format":"uuid","title":"Shipment Id","type":"string"}},{"description":"Último identificador recibido en la página anterior","in":"query","name":"cursor","required":false,"schema":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"description":"Último identificador recibido en la página anterior","title":"Cursor"}},{"in":"query","name":"limit","required":false,"schema":{"default":100,"maximum":200,"minimum":1,"title":"Limit","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/TrackingEventPageResponse"}}},"description":"Successful Response"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"Forbidden"},"404":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"Not Found"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"Unprocessable Entity"}},"security":[{"HTTPBearer":[]}],"summary":"Consultar el historial de seguimiento","tags":["shipments"]}},"/v1/webhook-subscriptions":{"get":{"operationId":"list_subscriptions_v1_webhook_subscriptions_get","responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/WebhookSubscriptionResponse"},"title":"Response List Subscriptions V1 Webhook Subscriptions Get","type":"array"}}},"description":"Successful Response"}},"security":[{"HTTPBearer":[]}],"summary":"List Subscriptions","tags":["webhooks"]},"post":{"operationId":"create_subscription_v1_webhook_subscriptions_post","requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/CreateWebhookSubscriptionRequest"}}},"required":true},"responses":{"201":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/IssuedWebhookSubscriptionResponse"}}},"description":"Successful Response"},"401":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"Unauthorized"},"403":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"Forbidden"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/ProblemDetail"}}},"description":"Unprocessable Entity"}},"security":[{"HTTPBearer":[]}],"summary":"Create Subscription","tags":["webhooks"]}},"/v1/webhook-subscriptions/deliveries":{"get":{"operationId":"list_deliveries_v1_webhook_subscriptions_deliveries_get","parameters":[{"in":"query","name":"subscription_id","required":false,"schema":{"anyOf":[{"format":"uuid","type":"string"},{"type":"null"}],"title":"Subscription Id"}},{"in":"query","name":"limit","required":false,"schema":{"default":100,"maximum":200,"minimum":1,"title":"Limit","type":"integer"}}],"responses":{"200":{"content":{"application/json":{"schema":{"items":{"$ref":"#/components/schemas/WebhookDeliveryResponse"},"title":"Response List Deliveries V1 Webhook Subscriptions Deliveries Get","type":"array"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"HTTPBearer":[]}],"summary":"List Deliveries","tags":["webhooks"]}},"/v1/webhook-subscriptions/deliveries/{delivery_id}/retry":{"post":{"operationId":"retry_delivery_v1_webhook_subscriptions_deliveries__delivery_id__retry_post","parameters":[{"in":"path","name":"delivery_id","required":true,"schema":{"format":"uuid","title":"Delivery Id","type":"string"}}],"responses":{"202":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/WebhookDeliveryResponse"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"HTTPBearer":[]}],"summary":"Retry Delivery","tags":["webhooks"]}},"/v1/webhook-subscriptions/{subscription_id}":{"patch":{"operationId":"update_subscription_v1_webhook_subscriptions__subscription_id__patch","parameters":[{"in":"path","name":"subscription_id","required":true,"schema":{"format":"uuid","title":"Subscription Id","type":"string"}}],"requestBody":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/UpdateWebhookSubscriptionRequest"}}},"required":true},"responses":{"200":{"content":{"application/json":{"schema":{"anyOf":[{"$ref":"#/components/schemas/WebhookSubscriptionResponse"},{"$ref":"#/components/schemas/IssuedWebhookSubscriptionResponse"}],"title":"Response Update Subscription V1 Webhook Subscriptions  Subscription Id  Patch"}}},"description":"Successful Response"},"422":{"content":{"application/json":{"schema":{"$ref":"#/components/schemas/HTTPValidationError"}}},"description":"Validation Error"}},"security":[{"HTTPBearer":[]}],"summary":"Update Subscription","tags":["webhooks"]}}},"tags":[{"description":"Estado técnico sin datos de negocio","name":"health"},{"description":"Conexiones y artículos visibles","name":"catalog"},{"description":"Creación y gestión de envíos","name":"shipments"},{"description":"Puntos de entrega y recogida con restricciones explícitas","name":"locations"},{"description":"Notificaciones salientes para clientes","name":"webhooks"},{"description":"Gobierno exclusivo de SendingBay sobre clientes y configuración","name":"administration"}]}