Una sucursal es una empresa que dependen de una casa matriz y puede estar ubicada dentro de la misma ciudad o fuera de ella.
En esta sección aprenderás cómo utilizar la API para insertar una colección de proveedores.
.jpg "Hubspot - nubox (29)")
Para insertar una colección de sucursales utilizaremos el verbo http POST.
API endpoint exclusivo para partners que trabajen con factura electronica.
| Formato de respuesta | JSON |
|---|---|
| ¿Requiere autenticación? | SI |
| ¿Requiere token? | SI |
| ¿Requiere Partner key? | NO |
| Nombre | Descripción | Tipo del parámetro | Tipo del dato |
|---|---|---|---|
| rut | Rut de la empresa | Path | String |
| numeroSerie | Número de serie del sistema, este valor se obtiene desde el resultado de la autenticación API | Path | Boolean |
| sucursales |
Arreglo de json de sucursales | Body | Json |
En el parámetro sucursales debes incluir un JSON con la siguiente estructura
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| CodigoSII | Integer | SI |
Código registrado en impuestos internos para la sucursal |
| DireccionLegal | String | SI | Dirección registrada de la sucursal |
| ComunaLegalId | Integer | SI | Valor numérico que representa a la comuna |
| Activa | Boolean | NO |
Indicador para marcar si la sucursal estara activa en el sistema. Valores Posibles: TRUE, FALSE |
| Codigo | String | SI | Código de la sucursal para el sistema, el valor debe ser único |
| Descripcion | String | SI | Descripción de la sucursal |
[ { "CodigoSII": 1, "DireccionLegal": "Av. Apoquindo 102", "ComunaLegalId": 2, "Activa": true, "Codigo": "Codigo 1", "Descripcion": "Sucursal Apoquindo" }, { "CodigoSII": 2, "DireccionLegal": "Av. Vitacura 2236", "ComunaLegalId": 33, "Activa": true, "Codigo": "Codigo 2", "Descripcion": "Sucursal Vitacura" } ]
En este apartado se entrega información importante que debes tener en consideración.
curl --location --request POST 'https://api.nubox.com/Nubox.API/factura/1-9/1/sucursales' \ --header 'token: 37998f88-7701-4c3b-9d2f-3fee2e53aebc' \ --header 'Content-Type: application/json' \ --header 'Cookie: .Stackify.Rum=4c648f24-1d4f-4817-a602-57005e5e24da' \ --data-raw '[ { "CodigoSII": 1, "DireccionLegal": "Av. Apoquindo 102", "ComunaLegalId": 473, "Activa": true, "Codigo": "Codigo 1", "Descripcion": "Sucursal Apoquindo" }, { "CodigoSII": 2, "DireccionLegal": "Av. Vitacura 2236", "ComunaLegalId": 473, "Activa": true, "Codigo": "Codigo 2", "Descripcion": "Sucursal Vitacura" } ]'
Failed to process https://raw.githubusercontent.com/MauricioRochaNubox/web-api-examples/master/factura/post-sucursales/jquery-request.js 404
Failed to process https://raw.githubusercontent.com/MauricioRochaNubox/web-api-examples/master/factura/post-sucursales/fetch-request.js 404
var data = JSON.stringify([{"CodigoSII":1,"DireccionLegal":"Av. Apoquindo 102","ComunaLegalId":473,"Activa":true,"Codigo":"Codigo 1","Descripcion":"Sucursal Apoquindo"},{"CodigoSII":2,"DireccionLegal":"Av. Vitacura 2236","ComunaLegalId":473,"Activa":true,"Codigo":"Codigo 2","Descripcion":"Sucursal Vitacura"}]); var xhr = new XMLHttpRequest(); xhr.withCredentials = true; xhr.addEventListener("readystatechange", function() { if(this.readyState === 4) { console.log(this.responseText); } }); xhr.open("POST", "https://api.nubox.com/Nubox.API/factura/1-9/1/sucursales"); xhr.setRequestHeader("token", "37998f88-7701-4c3b-9d2f-3fee2e53aebc"); xhr.setRequestHeader("Content-Type", "application/json"); xhr.setRequestHeader("Cookie", ".Stackify.Rum=4c648f24-1d4f-4817-a602-57005e5e24da"); xhr.send(data);
var request = require('request'); var options = { 'method': 'POST', 'url': 'https://api.nubox.com/Nubox.API/factura/1-9/1/sucursales', 'headers': { 'token': '37998f88-7701-4c3b-9d2f-3fee2e53aebc', 'Content-Type': 'application/json', 'Cookie': '.Stackify.Rum=4c648f24-1d4f-4817-a602-57005e5e24da' }, body: JSON.stringify([{"CodigoSII":1,"DireccionLegal":"Av. Apoquindo 102","ComunaLegalId":473,"Activa":true,"Codigo":"Codigo 1","Descripcion":"Sucursal Apoquindo"},{"CodigoSII":2,"DireccionLegal":"Av. Vitacura 2236","ComunaLegalId":473,"Activa":true,"Codigo":"Codigo 2","Descripcion":"Sucursal Vitacura"}]) }; request(options, function (error, response) { if (error) throw new Error(error); console.log(response.body); });
var client = new RestClient("https://api.nubox.com/Nubox.API/factura/1-9/1/sucursales"); client.Timeout = -1; var request = new RestRequest(Method.POST); request.AddHeader("token", "37998f88-7701-4c3b-9d2f-3fee2e53aebc"); request.AddHeader("Content-Type", "application/json"); request.AddHeader("Cookie", ".Stackify.Rum=4c648f24-1d4f-4817-a602-57005e5e24da"); request.AddParameter("application/json", "[\n {\n \"CodigoSII\": 1,\n \"DireccionLegal\": \"Av. Apoquindo 102\",\n \"ComunaLegalId\": 473,\n \"Activa\": true,\n \"Codigo\": \"Codigo 1\",\n \"Descripcion\": \"Sucursal Apoquindo\"\n },\n {\n \"CodigoSII\": 2,\n \"DireccionLegal\": \"Av. Vitacura 2236\",\n \"ComunaLegalId\": 473,\n \"Activa\": true,\n \"Codigo\": \"Codigo 2\",\n \"Descripcion\": \"Sucursal Vitacura\"\n }\n ]", ParameterType.RequestBody); IRestResponse response = client.Execute(request); Console.WriteLine(response.Content);
<?php $curl = curl_init(); curl_setopt_array($curl, array( CURLOPT_URL => 'https://api.nubox.com/Nubox.API/factura/1-9/1/sucursales', CURLOPT_RETURNTRANSFER => true, CURLOPT_ENCODING => '', CURLOPT_MAXREDIRS => 10, CURLOPT_TIMEOUT => 0, CURLOPT_FOLLOWLOCATION => true, CURLOPT_HTTP_VERSION => CURL_HTTP_VERSION_1_1, CURLOPT_CUSTOMREQUEST => 'POST', CURLOPT_POSTFIELDS =>'[ { "CodigoSII": 1, "DireccionLegal": "Av. Apoquindo 102", "ComunaLegalId": 473, "Activa": true, "Codigo": "Codigo 1", "Descripcion": "Sucursal Apoquindo" }, { "CodigoSII": 2, "DireccionLegal": "Av. Vitacura 2236", "ComunaLegalId": 473, "Activa": true, "Codigo": "Codigo 2", "Descripcion": "Sucursal Vitacura" } ]', CURLOPT_HTTPHEADER => array( 'token: 37998f88-7701-4c3b-9d2f-3fee2e53aebc', 'Content-Type: application/json', 'Cookie: .Stackify.Rum=4c648f24-1d4f-4817-a602-57005e5e24da' ), )); $response = curl_exec($curl); curl_close($curl); echo $response;
require "uri" require "net/http" url = URI("https://api.nubox.com/Nubox.API/factura/1-9/1/sucursales") https = Net::HTTP.new(url.host, url.port) https.use_ssl = true request = Net::HTTP::Post.new(url) request["token"] = "37998f88-7701-4c3b-9d2f-3fee2e53aebc" request["Content-Type"] = "application/json" request["Cookie"] = ".Stackify.Rum=4c648f24-1d4f-4817-a602-57005e5e24da" request.body = "[\n {\n \"CodigoSII\": 1,\n \"DireccionLegal\": \"Av. Apoquindo 102\",\n \"ComunaLegalId\": 473,\n \"Activa\": true,\n \"Codigo\": \"Codigo 1\",\n \"Descripcion\": \"Sucursal Apoquindo\"\n },\n {\n \"CodigoSII\": 2,\n \"DireccionLegal\": \"Av. Vitacura 2236\",\n \"ComunaLegalId\": 473,\n \"Activa\": true,\n \"Codigo\": \"Codigo 2\",\n \"Descripcion\": \"Sucursal Vitacura\"\n }\n ]" response = https.request(request) puts response.read_body
package main import ( "fmt" "strings" "net/http" "io/ioutil" ) func main() { url := "https://api.nubox.com/Nubox.API/factura/1-9/1/sucursales" method := "POST" payload := strings.NewReader(`[ { "CodigoSII": 1, "DireccionLegal": "Av. Apoquindo 102", "ComunaLegalId": 473, "Activa": true, "Codigo": "Codigo 1", "Descripcion": "Sucursal Apoquindo" }, { "CodigoSII": 2, "DireccionLegal": "Av. Vitacura 2236", "ComunaLegalId": 473, "Activa": true, "Codigo": "Codigo 2", "Descripcion": "Sucursal Vitacura" } ]`) client := &http.Client { } req, err := http.NewRequest(method, url, payload) if err != nil { fmt.Println(err) return } req.Header.Add("token", "37998f88-7701-4c3b-9d2f-3fee2e53aebc") req.Header.Add("Content-Type", "application/json") req.Header.Add("Cookie", ".Stackify.Rum=4c648f24-1d4f-4817-a602-57005e5e24da") res, err := client.Do(req) if err != nil { fmt.Println(err) return } defer res.Body.Close() body, err := ioutil.ReadAll(res.Body) if err != nil { fmt.Println(err) return } fmt.Println(string(body)) }
OkHttpClient client = new OkHttpClient().newBuilder() .build(); MediaType mediaType = MediaType.parse("application/json"); RequestBody body = RequestBody.create(mediaType, "[\n {\n \"CodigoSII\": 1,\n \"DireccionLegal\": \"Av. Apoquindo 102\",\n \"ComunaLegalId\": 473,\n \"Activa\": true,\n \"Codigo\": \"Codigo 1\",\n \"Descripcion\": \"Sucursal Apoquindo\"\n },\n {\n \"CodigoSII\": 2,\n \"DireccionLegal\": \"Av. Vitacura 2236\",\n \"ComunaLegalId\": 473,\n \"Activa\": true,\n \"Codigo\": \"Codigo 2\",\n \"Descripcion\": \"Sucursal Vitacura\"\n }\n ]"); Request request = new Request.Builder() .url("https://api.nubox.com/Nubox.API/factura/1-9/1/sucursales") .method("POST", body) .addHeader("token", "37998f88-7701-4c3b-9d2f-3fee2e53aebc") .addHeader("Content-Type", "application/json") .addHeader("Cookie", ".Stackify.Rum=4c648f24-1d4f-4817-a602-57005e5e24da") .build(); Response response = client.newCall(request).execute();
"Ejecutado correctamente."
| Nombre | Valor |
|---|---|
| cache-control | no-cache |
| content-length | 0 |
| content-type | application/json; charset=utf-8 |
| date | Thu, 16 Apr 2020 22:53:54 GMT |
