We Ship You

Tienda

WeShipYou
Compra productos seleccionados de vendedores WeShipYou, con fulfillment integral y garantía de envío.
Amazon
¡Compra en Amazon, la tienda más grande del mundo con la mayor variedad de productos, todo con la seguridad de WeShipYou!
eBay
Artículos nuevos y usados de vendedores en EE. UU.: compramos por ti los anuncios con “Cómpralo ahora”.
AliExpress
Millones de productos a precio de fábrica, comprados y enviados por nosotros.
Walmart
¡Compra productos de farmacia y supermercado en Walmart de forma rápida y fácil!
Shein
¡Compra los últimos productos de tendencia a los mejores precios con descuento, solo en la tienda Shein!
Temu
¡Compra los mejores productos a precios con descuento en la tienda Temu!
Shopify
Busca en miles de tiendas Shopify de EE. UU. a la vez, o pega un enlace de cualquiera de ellas.

Direcciones de la cuenta

Tu libreta de direcciones

GET/account-addresses
POST/account-addresses
PATCH/account-addresses/{accountAddressId}

El objeto Dirección de la cuenta

Una dirección guardada de una cuenta: un remitente, un destinatario o ambos.

Atributos

uidstringobligatorioadmite null
UID de la dirección. Úsalo como accountAddressId, o como uid del remitente / destinatario en un envío.
nicknamestringadmite null
Nombre que se muestra en las libretas de direcciones.
namestringadmite null
Nombre del contacto.
companyNamestringadmite null
Nombre de la empresa.
taxIdstringadmite null
Id fiscal del contacto.
emailstringadmite null
Correo del contacto.
phonestringadmite null
Teléfono del contacto, E.164.
birthdaystring <date-time>admite null
Fecha de nacimiento del contacto, cuando se recopila.
isRecipientboolean | integeradmite null
La dirección puede recibir envíos. 1/true o 0/false.
isSenderboolean | integeradmite null
La dirección puede enviar envíos. 1/true o 0/false.
isResidentialboolean | integeradmite null
La dirección es residencial. 1/true o 0/false.
statusstringobligatorioadmite null
Estado del registro.
addressobjectadmite null
Dirección postal. Se incluye cuando la dirección se lee sola.
Atributos anidados
- cityobject
  Atributos anidados
  namestringadmite null
  stateobject
  Atributos anidados
  namestringadmite null
- streetstring
  Dirección, incluido el número de edificio o apartamento.
- postalCodestring
countryobjectadmite null
País de la dirección. Se incluye cuando la dirección se lee sola.
Atributos anidados
- isoCodestring
  Valores permitidos:ADAEAFALAGAIAQAMAOARASATAUAWAXAZBABBBDBEBFBGBHBIBJBLBMBNBOBQBRBSBTBVBWBYBZCACCCDCFCGCHCICKCLCMCNCOCRCUCVCWCXCYCZDEDJDKDMDODZECEEEGEHERESETFIFJFKFMFOFRGAGBGDGEGFGGGHGIGLGMGNGPGQGRGSGTGUGWGYHKHMHNHRHTIDIEILIMINIOIQIRISITJEJMJOJPKEKGKHKIKMKNKPKRXKKWKYKZLALBLCLILKLRLSLTLULVLYMAMCMDMEMFMGMHMKMLMMHUMNMOMPMQMRMSMTMUMVMWMXMYMZNANCNENFNGNINLNONPNRNUNZOMPAPEPFPGPHPKPLPMPNPRPSPTPWPYQARERORSRURWSASBSCSDSSSESGSHSISJSKSLSMSNSOSRSTSVSXSYSZTCTDTFTGTHTJTKTLTMTNTOTRTTTVTWTZUAUGUMUSUYUZVAVCVEVGVIVNVUWFWSYTYEZAZMZWCSAN
  exactamente 2 caracteres
createdAtstring <date-time>obligatorioadmite null
Cuándo se guardó la dirección.
updatedAtstring <date-time>obligatorioadmite null
Cuándo cambió la dirección por última vez.

El objeto Dirección de la cuenta

{
  "uid": "3cl95vgkut4n",
  "nickname": null,
  "name": null,
  "companyName": null,
  "taxId": null,
  "email": null,
  "phone": null,
  "birthday": null,
  "isRecipient": 0,
  "isSender": 0,
  "isResidential": 0,
  "status": "active",
  "createdAt": "2026-11-01T00:37:55.000Z",
  "updatedAt": "2026-11-01T00:37:55.000Z"
}

Listar tu libreta de direcciones

GET/account-addresses

Requiere un token de acceso

Lista los remitentes y destinatarios guardados de tus cuentas.

Parámetros de consulta

accountIdstring
Limita los resultados a una de tus cuentas: su uid, su número de cuenta (CU…) o su número de cuenta externo. Sin él, se incluyen todas las cuentas a las que perteneces.
$limitnumber
Número máximo de resultados (20 por defecto).
Por defecto: 20
>= 0 · <= 500
$skipnumber
Número de resultados que se omiten, para paginar.
Por defecto: 0
>= 0

Parámetros de cabecera

Accept-Languagestring
Código de dos letras del idioma de los mensajes: en, es o pt.
Por defecto: en-US

Respuestas

200

Una página de tus direcciones guardadas.

totalintegerobligatorio
Número total de registros que coinciden.
limitintegerobligatorio
Tamaño de página usado en esta respuesta.
skipintegerobligatorio
Número de registros omitidos antes de esta página.
datalista de Dirección de la cuentaobligatorio
El objeto Dirección de la cuenta

401

Token de acceso ausente o no válido

namestring
Siempre NotAuthenticated
messagestring
codenumber
Siempre 401
classNamestring
Siempre not-authenticated
dataobject

403

No tienes acceso a esta cuenta

namestring
Siempre Forbidden
messagestring
codenumber
Siempre 403
classNamestring
Siempre forbidden
dataobject

GET/account-addresses

curl 'https://sandbox.weshipyou.com/api/v1/account-addresses' \
  -H "Authorization: Bearer $WSY_ACCESS_TOKEN"

Respuesta

{
  "total": 1,
  "limit": 20,
  "skip": 0,
  "data": [
    {
      "uid": "3cl95vgkut4n",
      "nickname": null,
      "name": null,
      "companyName": null,
      "taxId": null,
      "email": null,
      "phone": null,
      "birthday": null,
      "isRecipient": 0,
      "isSender": 0,
      "isResidential": 0,
      "status": "active",
      "createdAt": "2026-11-01T00:37:55.000Z",
      "updatedAt": "2026-11-01T00:37:55.000Z"
    }
  ]
}

PruébaloEnvía una solicitud real al entorno Prueba desde esta página, sin escribir código.

Guardar una dirección

POST/account-addresses

Requiere un token de acceso

Agrega un remitente o destinatario a la libreta de direcciones de una de tus cuentas (accountId).

Parámetros de cabecera

Accept-Languagestring
Código de dos letras del idioma de los mensajes: en, es o pt.
Por defecto: en-US

Cuerpo de la solicitudapplication/json

useExistingAddressboolean
nicknamestringadmite null
addressobjectobligatorio
Atributos anidados
- cityobject
  Atributos anidados
  namestringadmite null
  stateobject
  Atributos anidados
  namestringadmite null
- streetstring
  Dirección, incluido el número de edificio o apartamento.
- postalCodestring
namestringobligatorioadmite null
al menos 1 caracteres
companyNamestringadmite null
taxIdstringadmite null
taxIdCountryobject
Un país, por su código ISO 3166-1 alfa-2.
Atributos anidados
- isoCodestring
  Valores permitidos:ADAEAFALAGAIAQAMAOARASATAUAWAXAZBABBBDBEBFBGBHBIBJBLBMBNBOBQBRBSBTBVBWBYBZCACCCDCFCGCHCICKCLCMCNCOCRCUCVCWCXCYCZDEDJDKDMDODZECEEEGEHERESETFIFJFKFMFOFRGAGBGDGEGFGGGHGIGLGMGNGPGQGRGSGTGUGWGYHKHMHNHRHTIDIEILIMINIOIQIRISITJEJMJOJPKEKGKHKIKMKNKPKRXKKWKYKZLALBLCLILKLRLSLTLULVLYMAMCMDMEMFMGMHMKMLMMHUMNMOMPMQMRMSMTMUMVMWMXMYMZNANCNENFNGNINLNONPNRNUNZOMPAPEPFPGPHPKPLPMPNPRPSPTPWPYQARERORSRURWSASBSCSDSSSESGSHSISJSKSLSMSNSOSRSTSVSXSYSZTCTDTFTGTHTJTKTLTMTNTOTRTTTVTWTZUAUGUMUSUYUZVAVCVEVGVIVNVUWFWSYTYEZAZMZWCSAN
  exactamente 2 caracteres
phonestring <phone>obligatorioadmite null
al menos 1 caracteres
emailstring <email>obligatorioadmite null
Correo del destinatario
countryobjectobligatorio
Un país, por su código ISO 3166-1 alfa-2.
Atributos anidados
- isoCodestring
  Valores permitidos:ADAEAFALAGAIAQAMAOARASATAUAWAXAZBABBBDBEBFBGBHBIBJBLBMBNBOBQBRBSBTBVBWBYBZCACCCDCFCGCHCICKCLCMCNCOCRCUCVCWCXCYCZDEDJDKDMDODZECEEEGEHERESETFIFJFKFMFOFRGAGBGDGEGFGGGHGIGLGMGNGPGQGRGSGTGUGWGYHKHMHNHRHTIDIEILIMINIOIQIRISITJEJMJOJPKEKGKHKIKMKNKPKRXKKWKYKZLALBLCLILKLRLSLTLULVLYMAMCMDMEMFMGMHMKMLMMHUMNMOMPMQMRMSMTMUMVMWMXMYMZNANCNENFNGNINLNONPNRNUNZOMPAPEPFPGPHPKPLPMPNPRPSPTPWPYQARERORSRURWSASBSCSDSSSESGSHSISJSKSLSMSNSOSRSTSVSXSYSZTCTDTFTGTHTJTKTLTMTNTOTRTTTVTWTZUAUGUMUSUYUZVAVCVEVGVIVNVUWFWSYTYEZAZMZWCSAN
  exactamente 2 caracteres
accountIdstringobligatorio

Respuestas

201

La dirección guardada

El objeto Dirección de la cuenta

400

Error de validación; data contiene el mensaje de cada campo no válido

namestring
Siempre BadRequest
messagestring
codenumber
Siempre 400
classNamestring
Siempre bad-request
dataobject

401

Token de acceso ausente o no válido

namestring
Siempre NotAuthenticated
messagestring
codenumber
Siempre 401
classNamestring
Siempre not-authenticated
dataobject

403

No tienes acceso a esta cuenta

namestring
Siempre Forbidden
messagestring
codenumber
Siempre 403
classNamestring
Siempre forbidden
dataobject

POST/account-addresses

curl -X POST 'https://sandbox.weshipyou.com/api/v1/account-addresses' \
  -H "Authorization: Bearer $WSY_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "useExistingAddress": true,
  "nickname": "Main office",
  "address": {
    "city": {
      "name": "Homestead",
      "state": {
        "name": "Florida"
      }
    },
    "street": "924 NW 36 Ave",
    "postalCode": "33033"
  },
  "name": "John Doe",
  "companyName": "We Ship You Corp",
  "taxId": "88-1345985",
  "taxIdCountry": {
    "isoCode": "US"
  },
  "phone": "+1 (786) 651-0451",
  "email": "john.doe@weshipyou.com",
  "country": {
    "isoCode": "US"
  },
  "accountId": "CU1234567"
}'

Respuesta

{
  "uid": "a3neeyyhaytn",
  "nickname": "Warehouse",
  "name": "Jane Doe",
  "companyName": null,
  "email": "jane.doe@example.com",
  "phone": "+1 (305) 555-0100",
  "birthday": null,
  "isRecipient": false,
  "isSender": false,
  "isResidential": false,
  "status": "active",
  "createdAt": "2026-11-01T00:37:55.921Z",
  "updatedAt": "2026-11-01T00:37:55.921Z"
}

PruébaloEnvía una solicitud real al entorno Prueba desde esta página, sin escribir código.

Actualizar una dirección

PATCH/account-addresses/{accountAddressId}

Requiere un token de acceso

Cambia los campos que envías. Mientras la dirección la use un envío en tránsito o entregado, sus campos de identidad (nombre, teléfono, dirección, id fiscal, …) no pueden cambiar y la solicitud responde 400; guarda una dirección nueva en su lugar.

Parámetros de ruta

accountAddressIdstringobligatorio
El uid de la dirección.

Parámetros de cabecera

Accept-Languagestring
Código de dos letras del idioma de los mensajes: en, es o pt.
Por defecto: en-US

Cuerpo de la solicitudapplication/json

useExistingAddressboolean
nicknamestringadmite null
addressobjectobligatorio
Atributos anidados
- cityobject
  Atributos anidados
  namestringadmite null
  stateobject
  Atributos anidados
  namestringadmite null
- streetstring
  Dirección, incluido el número de edificio o apartamento.
- postalCodestring
namestringobligatorioadmite null
al menos 1 caracteres
companyNamestringadmite null
taxIdstringadmite null
taxIdCountryobject
Un país, por su código ISO 3166-1 alfa-2.
Atributos anidados
- isoCodestring
  Valores permitidos:ADAEAFALAGAIAQAMAOARASATAUAWAXAZBABBBDBEBFBGBHBIBJBLBMBNBOBQBRBSBTBVBWBYBZCACCCDCFCGCHCICKCLCMCNCOCRCUCVCWCXCYCZDEDJDKDMDODZECEEEGEHERESETFIFJFKFMFOFRGAGBGDGEGFGGGHGIGLGMGNGPGQGRGSGTGUGWGYHKHMHNHRHTIDIEILIMINIOIQIRISITJEJMJOJPKEKGKHKIKMKNKPKRXKKWKYKZLALBLCLILKLRLSLTLULVLYMAMCMDMEMFMGMHMKMLMMHUMNMOMPMQMRMSMTMUMVMWMXMYMZNANCNENFNGNINLNONPNRNUNZOMPAPEPFPGPHPKPLPMPNPRPSPTPWPYQARERORSRURWSASBSCSDSSSESGSHSISJSKSLSMSNSOSRSTSVSXSYSZTCTDTFTGTHTJTKTLTMTNTOTRTTTVTWTZUAUGUMUSUYUZVAVCVEVGVIVNVUWFWSYTYEZAZMZWCSAN
  exactamente 2 caracteres
phonestring <phone>obligatorioadmite null
al menos 1 caracteres
emailstring <email>obligatorioadmite null
Correo del destinatario
countryobjectobligatorio
Un país, por su código ISO 3166-1 alfa-2.
Atributos anidados
- isoCodestring
  Valores permitidos:ADAEAFALAGAIAQAMAOARASATAUAWAXAZBABBBDBEBFBGBHBIBJBLBMBNBOBQBRBSBTBVBWBYBZCACCCDCFCGCHCICKCLCMCNCOCRCUCVCWCXCYCZDEDJDKDMDODZECEEEGEHERESETFIFJFKFMFOFRGAGBGDGEGFGGGHGIGLGMGNGPGQGRGSGTGUGWGYHKHMHNHRHTIDIEILIMINIOIQIRISITJEJMJOJPKEKGKHKIKMKNKPKRXKKWKYKZLALBLCLILKLRLSLTLULVLYMAMCMDMEMFMGMHMKMLMMHUMNMOMPMQMRMSMTMUMVMWMXMYMZNANCNENFNGNINLNONPNRNUNZOMPAPEPFPGPHPKPLPMPNPRPSPTPWPYQARERORSRURWSASBSCSDSSSESGSHSISJSKSLSMSNSOSRSTSVSXSYSZTCTDTFTGTHTJTKTLTMTNTOTRTTTVTWTZUAUGUMUSUYUZVAVCVEVGVIVNVUWFWSYTYEZAZMZWCSAN
  exactamente 2 caracteres

Respuestas

200

La dirección actualizada

El objeto Dirección de la cuenta

400

Error de validación, o un campo bloqueado de una dirección en uso

namestring
Siempre BadRequest
messagestring
codenumber
Siempre 400
classNamestring
Siempre bad-request
dataobject

401

Token de acceso ausente o no válido

namestring
Siempre NotAuthenticated
messagestring
codenumber
Siempre 401
classNamestring
Siempre not-authenticated
dataobject

403

No tienes acceso a esta cuenta

namestring
Siempre Forbidden
messagestring
codenumber
Siempre 403
classNamestring
Siempre forbidden
dataobject

404

Ningún envío tiene ese id

namestring
Siempre NotFound
messagestring
codenumber
Siempre 404
classNamestring
Siempre not-found
dataobject

PATCH/account-addresses/{accountAddressId}

curl -X PATCH 'https://sandbox.weshipyou.com/api/v1/account-addresses/{accountAddressId}' \
  -H "Authorization: Bearer $WSY_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
  "useExistingAddress": true,
  "nickname": "Main office",
  "address": {
    "city": {
      "name": "Homestead",
      "state": {
        "name": "Florida"
      }
    },
    "street": "924 NW 36 Ave",
    "postalCode": "33033"
  },
  "name": "John Doe",
  "companyName": "We Ship You Corp",
  "taxId": "88-1345985",
  "taxIdCountry": {
    "isoCode": "US"
  },
  "phone": "+1 (786) 651-0451",
  "email": "john.doe@weshipyou.com",
  "country": {
    "isoCode": "US"
  }
}'

Respuesta

{
  "uid": "3cl95vgkut4n",
  "nickname": "Office",
  "name": null,
  "companyName": null,
  "taxId": null,
  "email": null,
  "phone": null,
  "birthday": null,
  "isRecipient": 0,
  "isSender": 0,
  "isResidential": 0,
  "status": "active",
  "createdAt": "2026-11-01T00:37:55.000Z",
  "updatedAt": "2026-11-01T00:37:55.000Z"
}

PruébaloEnvía una solicitud real al entorno Prueba desde esta página, sin escribir código.