# ShipSaving Legacy API

Version: v1
License: Apache 2.0

## Servers

Servidor de producción
```
https://api.shipsaving.com
```

## Security

### ApiTokenAuth

Type: apiKey
In: query
Name: api_token

## Download OpenAPI description

[ShipSaving Legacy API](https://docs.shipsaving.com/_bundle/@l10n/es/v1/openapi.yaml)

## Gestión de etiquetas

### Obtener tarifa

 - [POST /api/rates/list](https://docs.shipsaving.com/es/v1/openapi/gestion-de-etiquetas/getratelist.md): Obtiene tarifas de envío para un paquete y una dirección determinados.  Límite de tasa: 600 solicitudes por minuto.

### Comprar etiqueta

 - [GET /api/rates/buy](https://docs.shipsaving.com/es/v1/openapi/gestion-de-etiquetas/purchaselabel.md): Compra una etiqueta de envío a partir del ID de tarifa indicado.
Límite de tasa: 600 solicitudes por minuto.

### Compra directa de etiqueta

 - [POST /api/rates/buy-label](https://docs.shipsaving.com/es/v1/openapi/gestion-de-etiquetas/directlybuylabel.md): Compra una etiqueta de envío directamente, sin comparar varias opciones de transportistas. Este endpoint solo es aplicable cuando hay un único transportista configurado para cada tipo de transportista en la cuenta del usuario. Si existen varios transportistas del mismo tipo, utiliza la API de Obtener tarifa para recuperar las opciones y, a continuación, llama a la API de Comprar etiqueta para completar la compra.  Límite de tasa: 600 solicitudes por minuto.

### Anular etiqueta

 - [POST /api/shipments/void](https://docs.shipsaving.com/es/v1/openapi/gestion-de-etiquetas/voidlabel.md): Anula una etiqueta de envío comprada utilizando el número de rastreo del envío.   Límite de tasa: 600 solicitudes por minuto.

## Gestión de pedidos

### Crear pedidos

 - [POST /api/orders/create](https://docs.shipsaving.com/es/v1/openapi/gestion-de-pedidos/createorders.md): Crea un nuevo pedido en el sistema de ShipSaving. Se utiliza habitualmente para crear pedidos por adelantado antes de generar etiquetas de envío.
Límite de tasa: 300 solicitudes por minuto.

### Consultar etiquetas del pedido

 - [GET /api/shipments/get](https://docs.shipsaving.com/es/v1/openapi/gestion-de-pedidos/checkorderlabels.md): Obtiene los detalles de la etiqueta de envío para una tienda y un número de pedido específicos. Solo aplicable a pedidos con una etiqueta de envío ya comprada. Límite de tasa: 120 solicitudes por minuto.

### Eliminar un pedido

 - [DELETE /api/orders/delete](https://docs.shipsaving.com/es/v1/openapi/gestion-de-pedidos/deleteorder.md): Elimina un pedido existente del sistema de ShipSaving especificando el nombre de la tienda y el número de pedido. Esta acción es irreversible y eliminará permanentemente el pedido y todos sus datos asociados. Límite de tasa: 300 solicitudes por minuto.

## Validación de direcciones

### Validación de direcciones

 - [POST /api/addresses/verify](https://docs.shipsaving.com/es/v1/openapi/validacion-de-direcciones/verifyaddress.md): Verifica y estandariza una dirección a partir de los datos proporcionados.
Esta API comprueba si hay errores y devuelve sugerencias o correcciones. 
Límite de tasa: 600 solicitudes por minuto.

## SCAN Form

### Crear SCAN Form de USPS

 - [POST /api/shipments/scan-forms/create](https://docs.shipsaving.com/es/v1/openapi/scan-form/createscanforms.md): Crea un SCAN Form de USPS para la lista de números de rastreo de envío proporcionada.
Solo es aplicable a envíos con números de rastreo USPS válidos. 
Límite de tasa: 60 solicitudes por minuto.

### Crear SCAN Form de DHL eCommerce

 - [POST /api/shipments/scan-forms/dhl/ecommerce/create](https://docs.shipsaving.com/es/v1/openapi/scan-form/createecsscanforms.md): Inicia la creación asíncrona de un SCAN Form de DHL eCommerce. Devuelve un ID de solicitud que puede utilizarse con el endpoint Obtener SCAN Form de DHL eCommerce para recuperar el PDF final del manifiesto.   Límite de tasa: 60 solicitudes por minuto.

### Obtener SCAN Form de DHL eCommerce

 - [GET /api/shipments/scan-forms/dhl/ecommerce/get](https://docs.shipsaving.com/es/v1/openapi/scan-form/getecsscanforms.md): Devuelve la URL del PDF del SCAN Form de DHL eCommerce a partir del ID de solicitud devuelto por el endpoint de creación.   Límite de tasa: 60 solicitudes por minuto.

## Gestión de transportistas

### Obtener lista de cuentas de transportistas

 - [GET /api/carrier-account/list](https://docs.shipsaving.com/es/v1/openapi/gestion-de-transportistas/getcarrieraccountlist.md): Obtiene la lista de cuentas de transportistas asociadas al token de API autenticado.
Límite de tasa: 60 solicitudes por minuto.

## Gestión de la cuenta

### Obtener saldo de la cuenta

 - [GET /api/balance](https://docs.shipsaving.com/es/v1/openapi/gestion-de-la-cuenta/querybalance.md): Obtiene el saldo de la cuenta en USD en tiempo real.
Límite de tasa: 60 solicitudes por minuto.