Documentación API New Bytes

Direcciones

Listar direcciones

  • En la carpeta Mi cuenta > Direcciones > [GET] Obtener direcciones.
https://api.nb.com.ar/v1/miCuenta/shippingAddress

Saber más sobre [GET] Obtener direcciones

Agregar dirección

  • En la carpeta Mi cuenta > Direcciones > [POST] Agregar dirección.
https://api.nb.com.ar/v1/miCuenta/shippingAddress

Saber más sobre [POST] Agregar dirección

  • Modificar los datos del body de la solicitud según lo que indiquen los parámetros.
JSON
{
        "direccion": "Av siempreviva 123", // nombre de la av, calle con altura (sin localidad ni provincia)
        "telefono": "1530510267",
        "placeId": "BSAS", // Id de la localidad
        "codigoPostal": "1407", // Código postal
        "predeterminado": null  // si será la favorita para el usuario se marca true     
}
  • En el caso de placeId ingresar a la carpeta.
    Demografía > GET Obtener provincias.
https://api.nb.com.ar/v1/provinces

Saber más sobre [GET] Obtener provincia

  • Según la provincia a elegir copiar el id.
  • Ingresar a la carpeta Demografía > GET Obtener localidades.
  • Sustituir el id de la provincia de la solicitud.
https://api.nb.com.ar/v1/places/{id}

Saber más sobre [GET] Obtener localidades

  • Hacer clic en SEND.
  • El alphaCode que devuelve será el ID que hay que colocar en el placeId cuando se quiere guardar la dirección.

Una vez creada la dirección se obtiene como respuesta lo siguiente:

JSON
{
    "success": "ok",
    "msg": "Direccion agregada correctamente",
    "addressId": 31540 // idDirCli
}

Donde “addressId” es el “idDirCli“, es decir, el id de la dirección del cliente que se usa cuando se procesa la compra / carrito cuando tiene medio de envío

Nota: También existe la posibilidad de enviar solo el ID de provincia “provinceId” y en lugar de “placeId”, se reemplaza por “placeString”, que sería el nombre de la localidad. El objeto para usar en el body de la solicitud de agregar dirección quedaría así:

JSON
{
        "direccion": "ACASSUSO 1234",
        "telefono": "1530510267",
        "codigoPostal": "1407",
        "predeterminado": null,
        "provinceId" : 2, // Nuevo parámetro para la provincia
        "placeString": "ACASUSO" // Nuevo parámetro para la localidad
        
}

No son combinables las formas de enviar. O se envía provinceId con placeString o se envía el placeId.

Actualizar dirección

  • En la carpeta Mi cuenta > Direcciones > [PATCH] Update direccion
https://api.nb.com.ar/v1/miCuenta/shippingAddress

Saber más sobre [PATCH] Update dirección

  • Repetir los pasos de Agregar dirección

Eliminar dirección

  • En la carpeta Mi cuenta > Direcciones > [DELETE] Eliminar dirección
https://api.nb.com.ar/v1/miCuenta/shippingAddress/{id}

Saber más sobre [DELETE] Eliminar dirección

  • En la solicitud sustituir el Id por el Id de la dirección que se desea eliminar que se puede encontrar al Listar las direcciones