Un pago es la acción que se realiza para cancelar una obligación, de esta manera, el proveedor indica que el pago ha sido recibido y el cliente es consciente que el dinero ha llegado al acreedor.
En esta sección aprenderás cómo utilizar la API para insertar pagos en contabilidad.
.jpg "Hubspot - nubox (14)")
Para insertar un pago utilizaremos el verbo http POST, puedes pagar documentos como facturas, facturas electrónicas, boletas, etc, solo asegurate que el documento que estás pagando ya exista en el sistema.
API endpoint exclusivo para partners, requieres de un partner key para utilizarlo
| Formato de respuesta | JSON |
|---|---|
| ¿Requiere autenticación? | SI |
| ¿Requiere token? | SI |
| ¿Requiere Partner key? | SI |
| Nombre | Descripción | Tipo del parámetro | Tipo del dato |
|---|---|---|---|
| Pago | Representa un documento de pago en formato JSON. | Body | Json |
| PartnerKey | Llave que identifica al partner como único. | Header | String |
En el parámetro Pago debes incluir un JSON con la siguiente estructura.
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| NumeroSerie | Integer | SI | Número de serie del sistema, este valor se obtiene desde el resultado de la autenticación API |
| RutContraparteEmisor | String | SI | Rut de la contraparte que emite la venta |
| RutEmpresaReceptor | String | SI | Rut de la empresa que recibe la compra |
| CodigoMedioDePago | String | SI | Medio de pago de los documentos contenidos |
| Fecha | String | SI | Fecha de realización del pago. |
| MontoTotal | Integer | SI | Monto total del pago. |
| DetalleDocumentos | Array | SI | Detalle de documentos a pagar |
{ "NumeroSerie": 0, "RutContraparteEmisor": "string", "RutEmpresaReceptor": "string", "CodigoMedioDePago": "string", "Fecha": "2020-05-11T13:08:44.556Z", "MontoTotal": 0, "DetalleDocumentos": [ { "Folio": 0, "CodigoSIITipoDoc": 0, "Monto": 0 } ] }
En el parámetro detalle de documento debes incluir un JSON con la siguiente estructura
| Nombre | Tipo | Obligatorio | Descripción |
|---|---|---|---|
| Folio | Integer | SI | Número identificador de la compra o venta. |
| CodigoSIITipoDoc | Integer | SI |
Código entregado por el SII |
| Monto | Integer | SI | Monto a pagar. |
"DetalleDocumentos": [ { "Folio": 1, "CodigoSIITipoDoc": 33, "Monto": 1000 }, { "Folio": 2, "CodigoSIITipoDoc": 33, "Monto": 1500 } ]
curl --location --request POST 'https://api.nubox.com/nubox.api/Pago/' \ --header 'PartnerKey: eYP4xLMXBxqusvRz22L0dTNk' \ --header 'token: aaf102b1-77ac-4f69-b833-122c478f15d3' \ --header 'Content-Type: application/json' \ --header 'Cookie: .Stackify.Rum=4c648f24-1d4f-4817-a602-57005e5e24da' \ --data-raw '{ "NumeroSerie": 1, "RutContraparteEmisor": "16197839-6", "RutEmpresaReceptor": "7964492-7", "CodigoMedioDePago": "EFECTIVO", "Fecha": "2020-04-14", "MontoTotal": 40984, "DetalleDocumentos": [ { "Folio": 12, "CodigoSIITipoDoc": 33, "Monto": 40984 } ] } '
var settings = { "url": "https://api.nubox.com/nubox.api/Pago/", "method": "POST", "timeout": 0, "headers": { "PartnerKey": "eYP4xLMXBxqusvRz22L0dTNk", "token": "aaf102b1-77ac-4f69-b833-122c478f15d3", "Content-Type": "application/json", "Cookie": ".Stackify.Rum=4c648f24-1d4f-4817-a602-57005e5e24da" }, "data": JSON.stringify({"NumeroSerie":1,"RutContraparteEmisor":"16197839-6","RutEmpresaReceptor":"7964492-7","CodigoMedioDePago":"EFECTIVO","Fecha":"2020-04-14","MontoTotal":40984,"DetalleDocumentos":[{"Folio":12,"CodigoSIITipoDoc":33,"Monto":40984}]}), }; $.ajax(settings).done(function (response) { console.log(response); });
var myHeaders = new Headers(); myHeaders.append("PartnerKey", "eYP4xLMXBxqusvRz22L0dTNk"); myHeaders.append("token", "aaf102b1-77ac-4f69-b833-122c478f15d3"); myHeaders.append("Content-Type", "application/json"); myHeaders.append("Cookie", ".Stackify.Rum=4c648f24-1d4f-4817-a602-57005e5e24da"); var raw = JSON.stringify({"NumeroSerie":1,"RutContraparteEmisor":"16197839-6","RutEmpresaReceptor":"7964492-7","CodigoMedioDePago":"EFECTIVO","Fecha":"2020-04-14","MontoTotal":40984,"DetalleDocumentos":[{"Folio":12,"CodigoSIITipoDoc":33,"Monto":40984}]}); var requestOptions = { method: 'POST', headers: myHeaders, body: raw, redirect: 'follow' }; fetch("https://api.nubox.com/nubox.api/Pago/", requestOptions) .then(response => response.text()) .then(result => console.log(result)) .catch(error => console.log('error', error));
var data = JSON.stringify({"NumeroSerie":1,"RutContraparteEmisor":"16197839-6","RutEmpresaReceptor":"7964492-7","CodigoMedioDePago":"EFECTIVO","Fecha":"2020-04-14","MontoTotal":40984,"DetalleDocumentos":[{"Folio":12,"CodigoSIITipoDoc":33,"Monto":40984}]}); 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/Pago/"); xhr.setRequestHeader("PartnerKey", "eYP4xLMXBxqusvRz22L0dTNk"); xhr.setRequestHeader("token", "aaf102b1-77ac-4f69-b833-122c478f15d3"); 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/Pago/', 'headers': { 'PartnerKey': 'eYP4xLMXBxqusvRz22L0dTNk', 'token': 'aaf102b1-77ac-4f69-b833-122c478f15d3', 'Content-Type': 'application/json', 'Cookie': '.Stackify.Rum=4c648f24-1d4f-4817-a602-57005e5e24da' }, body: JSON.stringify({"NumeroSerie":1,"RutContraparteEmisor":"16197839-6","RutEmpresaReceptor":"7964492-7","CodigoMedioDePago":"EFECTIVO","Fecha":"2020-04-14","MontoTotal":40984,"DetalleDocumentos":[{"Folio":12,"CodigoSIITipoDoc":33,"Monto":40984}]}) }; 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/Pago/"); client.Timeout = -1; var request = new RestRequest(Method.POST); request.AddHeader("PartnerKey", "eYP4xLMXBxqusvRz22L0dTNk"); request.AddHeader("token", "aaf102b1-77ac-4f69-b833-122c478f15d3"); request.AddHeader("Content-Type", "application/json"); request.AddHeader("Cookie", ".Stackify.Rum=4c648f24-1d4f-4817-a602-57005e5e24da"); request.AddParameter("application/json", "{\r\n \"NumeroSerie\": 1,\r\n \"RutContraparteEmisor\": \"16197839-6\",\r\n \"RutEmpresaReceptor\": \"7964492-7\",\r\n \"CodigoMedioDePago\": \"EFECTIVO\",\r\n \"Fecha\": \"2020-04-14\",\r\n \"MontoTotal\": 40984,\r\n \"DetalleDocumentos\": [\r\n {\r\n \"Folio\": 12,\r\n \"CodigoSIITipoDoc\": 33,\r\n \"Monto\": 40984\r\n }\r\n ]\r\n}\r\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/Pago/',
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 =>'{
"NumeroSerie": 1,
"RutContraparteEmisor": "16197839-6",
"RutEmpresaReceptor": "7964492-7",
"CodigoMedioDePago": "EFECTIVO",
"Fecha": "2020-04-14",
"MontoTotal": 40984,
"DetalleDocumentos": [
{
"Folio": 12,
"CodigoSIITipoDoc": 33,
"Monto": 40984
}
]
}
',
CURLOPT_HTTPHEADER => array(
'PartnerKey: eYP4xLMXBxqusvRz22L0dTNk',
'token: aaf102b1-77ac-4f69-b833-122c478f15d3',
'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/Pago/") https = Net::HTTP.new(url.host, url.port) https.use_ssl = true request = Net::HTTP::Post.new(url) request["PartnerKey"] = "eYP4xLMXBxqusvRz22L0dTNk" request["token"] = "aaf102b1-77ac-4f69-b833-122c478f15d3" request["Content-Type"] = "application/json" request["Cookie"] = ".Stackify.Rum=4c648f24-1d4f-4817-a602-57005e5e24da" request.body = "{\r\n \"NumeroSerie\": 1,\r\n \"RutContraparteEmisor\": \"16197839-6\",\r\n \"RutEmpresaReceptor\": \"7964492-7\",\r\n \"CodigoMedioDePago\": \"EFECTIVO\",\r\n \"Fecha\": \"2020-04-14\",\r\n \"MontoTotal\": 40984,\r\n \"DetalleDocumentos\": [\r\n {\r\n \"Folio\": 12,\r\n \"CodigoSIITipoDoc\": 33,\r\n \"Monto\": 40984\r\n }\r\n ]\r\n}\r\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/Pago/" method := "POST" payload := strings.NewReader(`{`+" "+` "NumeroSerie": 1,`+" "+` "RutContraparteEmisor": "16197839-6",`+" "+` "RutEmpresaReceptor": "7964492-7",`+" "+` "CodigoMedioDePago": "EFECTIVO",`+" "+` "Fecha": "2020-04-14",`+" "+` "MontoTotal": 40984,`+" "+` "DetalleDocumentos": [`+" "+` {`+" "+` "Folio": 12,`+" "+` "CodigoSIITipoDoc": 33,`+" "+` "Monto": 40984`+" "+` }`+" "+` ]`+" "+` }`+" "+` `) client := &http.Client { } req, err := http.NewRequest(method, url, payload) if err != nil { fmt.Println(err) return } req.Header.Add("PartnerKey", "eYP4xLMXBxqusvRz22L0dTNk") req.Header.Add("token", "aaf102b1-77ac-4f69-b833-122c478f15d3") 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, "{\r\n \"NumeroSerie\": 1,\r\n \"RutContraparteEmisor\": \"16197839-6\",\r\n \"RutEmpresaReceptor\": \"7964492-7\",\r\n \"CodigoMedioDePago\": \"EFECTIVO\",\r\n \"Fecha\": \"2020-04-14\",\r\n \"MontoTotal\": 40984,\r\n \"DetalleDocumentos\": [\r\n {\r\n \"Folio\": 12,\r\n \"CodigoSIITipoDoc\": 33,\r\n \"Monto\": 40984\r\n }\r\n ]\r\n}\r\n");
Request request = new Request.Builder()
.url("https://api.nubox.com/nubox.api/Pago/")
.method("POST", body)
.addHeader("PartnerKey", "eYP4xLMXBxqusvRz22L0dTNk")
.addHeader("token", "aaf102b1-77ac-4f69-b833-122c478f15d3")
.addHeader("Content-Type", "application/json")
.addHeader("Cookie", ".Stackify.Rum=4c648f24-1d4f-4817-a602-57005e5e24da")
.build();
Response response = client.newCall(request).execute();
N/A
| 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 |
