Órdenes

En esta sección se explican los Endpoints que permiten gestionar las órdenes de tu empresa.

Crear una Orden

Cuando se realice una compra en tu e-commerce utiliza este endpoint para indicarle a Buenvío que deseas crear una orden perteneciente a dicha compra, la orden puede contener varios paquetes a ser envíados a la dirección de tu comprador.

JavaScript

Python

PHP

WordPress

Dart

const params = {
  'customer_name': 'John Doe',
  'customer_email': '[email protected]',
  'customer_phone': '(809) 555-5555',
  'address_street': 'Calle 1',
  'address_building_number': '111',
  'address_city': 2,
  'address_reference': 'Esquina Calle 2',
  'address_sector': 'Los Jardines',
  'address_representative_name': 'Jane Doe',
  'address_representative_phone': '(829) 555-5555',
  'packages_quantity': 2,
  'fragile_packages_quantity': 1,
};

const body = Object.keys(params)
  .map((key) => encodeURIComponent(key) + '=' + encodeURIComponent(params[key]))
  .join('&');

fetch('https://api.buenvio.com/business/v1/orders/', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/x-www-form-urlencoded;charset=UTF-8',
    Authorization: '<YOUR_API_TOKEN>',
  },
  mode: 'cors',
  body: body,
})
  .then((response) => {
    return response.json();
  })
  .then((data) => {
    console.log(data);
  });

# Requiere usar la dependencia https://requests.readthedocs.io/en/master/

import requests

response = requests.post(
    'https://api.buenvio.com/business/v1/orders/', 
    headers={
        'Authorization': '<YOUR_API_TOKEN>'
    },
    data={
        'customer_name': 'John Doe',
        'customer_email': '[email protected]',
        'customer_phone': '(809) 555-5555',
        'address_street': 'Calle 1',
        'address_building_number': '111',
        'address_city': 2,
        'address_reference': 'Esquina Calle 2',
        'address_sector': 'Los Jardines',
        'address_representative_name': 'Jane Doe',
        'address_representative_phone': '(829) 555-5555',
        'packages_quantity': 2,
        'fragile_packages_quantity': 1,
    }
)

print(str(response.text)

// Requiere usar la dependencia http://docs.guzzlephp.org/

$client = new GuzzleHttp\Client();

$response = $client->request(
    'POST', 
    'https://api.buenvio.com/business/v1/orders/',
    [
        'headers' => [
            'Authorization' => '<YOUR_API_TOKEN>'
        ],
        'form_params' => [
            'customer_name' => 'John Doe',
            'customer_email' => '[email protected]',
            'customer_phone' => '(809) 555-5555',
            'address_street' => 'Calle 1',
            'address_building_number' => '111',
            'address_city' => 2,
            'address_reference' => 'Esquina Calle 2',
            'address_sector' => 'Los Jardines',
            'address_representative_name' => 'Jane Doe',
            'address_representative_phone' => '(829) 555-5555',
            'packages_quantity' => 2,
            'fragile_packages_quantity' => 1,
        ]
    ]
);

$data = json_decode($response->getBody());

var_dump($data);

$response = wp_remote_post(
    'https://api.buenvio.com/business/v1/orders/', 
    [
        'method' => 'POST',
        'headers' => [
            'Authorization' => '<YOUR_API_TOKEN>'        
        ],
        'body' => [
            'customer_name' => 'John Doe',
            'customer_email' => '[email protected]',
            'customer_phone' => '(809) 555-5555',
            'address_street' => 'Calle 1',
            'address_building_number' => '111',
            'address_city' => 2,
            'address_reference' => 'Esquina Calle 2',
            'address_sector' => 'Los Jardines',
            'address_representative_name' => 'Jane Doe',
            'address_representative_phone' => '(829) 555-5555',
            'packages_quantity' => 2,
            'fragile_packages_quantity' => 1,
        ]
    ]
);

if (is_wp_error($response)) {
    $error_message = $response->get_error_message();
    var_dump($error_message);
} else {
    var_dump($response);
}

// Requiere usar la dependencia https://pub.dev/packages/http/

import 'package:http/http.dart' as http;

http.post(
    'https://api.buenvio.com/business/v1/orders/',
    headers: {
        'Authorization': '<YOUR_API_TOKEN>',
    },
    body: {
        'customer_name': 'John Doe',
        'customer_email': '[email protected]',
        'customer_phone': '(809) 555-5555',
        'address_street': 'Calle 1',
        'address_building_number': '111',
        'address_city': 2,
        'address_reference': 'Esquina Calle 2',
        'address_sector': 'Los Jardines',
        'address_representative_name': 'Jane Doe',
        'address_representative_phone': '(829) 555-5555',
        'packages_quantity': 2,
        'fragile_packages_quantity': 1,
    }
).then((response) {
    print(response.body);
});