The Spanish version is the authoritative reference. View in Spanish

361 General Negotiation

POST

📋 Description

Allows registering an electronic negotiable instrument with general negotiation, where any third party can acquire the rights to the instrument. This event must be the first in the negotiable instrument's life cycle.

When to use this endpoint

When you need to register an electronic invoice as a negotiable instrument
The instrument will be available for open negotiation in the market
It is the first event that must be registered before any operation on the instrument

Endpoints

POST https://developers-sbx.gosocket.net/api/v1/Document/SendEventToAuthority
POST https://developers.gosocket.net/api/v1/Document/SendEventToAuthority

HTTP Method

POST

Authentication

Type: Basic Auth

You must provide your API credentials in each request via Basic Authentication.

Authorization: Basic base64(username:password)

Body Parameters

Field	Type	Required	Description	Example
`status`	string	✅ Yes	Event status code (036 = Registration)	`036`
`description`	string	✅ Yes	Event type description	`Inscripcion`
`operationType`	string	✅ Yes	Operation type (361 = General negotiation)	`361`
`valuePaid`	string	✅ Yes	Amount paid at the time of registration (generally 0)	`0`
`valueInvoice`	string	✅ Yes	Total value of the invoice/negotiable instrument	`432000`
`IDEmisor`	string	✅ Yes	NIT of the invoice issuer	`900000000`
`IDEmisorTipo`	string	✅ Yes	Identification type (31 = NIT)	`31`
`NombreEmisor`	string	✅ Yes	Legal name of the issuer	`EMPRESA EMISORA DE PRUEBA S.A.`
`InvoiceID`	string	✅ Yes	Electronic invoice number	`SETP991010111`
`docType`	string	✅ Yes	Document type (01 = Sales invoice)	`01`
`CUFEInvoice`	string	✅ Yes	CUFE (Unique Electronic Invoice Code)	`36bc2f7c4d018b3dcb8935129ec0...`
`IssueDate`	string	✅ Yes	Invoice issue date (format: YYYY-MM-DD)	`2023-01-03`
`EndDateInvoice`	string	✅ Yes	Instrument due date (format: YYYY-MM-DD)	`2023-01-13`

Code Examples

curl -X POST 'https://developers-sbx.gosocket.net/api/v1/Document/SendEventToAuthority' \
  -u 'username:password' \
  -d '{
  "status": "036",
  "description": "Inscripcion",
  "operationType": "361",
  "valuePaid": "0",
  "valueInvoice": "432000",
  "IDEmisor": "900000000",
  "IDEmisorTipo": "31",
  "NombreEmisor": "EMPRESA EMISORA DE PRUEBA S.A.",
  "InvoiceID": "SETP991010111",
  "docType": "01",
  "CUFEInvoice": "36bc2f7c4d018b3dcb8935129ec0fdf5f01bd7f1ff8867037766a837d73f1c51e9d1c3eaada76a94d6751de8ceeccdc6",
  "IssueDate": "2023-01-03",
  "EndDateInvoice": "2023-01-13"
}'

import requests
import json

url = "https://developers-sbx.gosocket.net/api/v1/Document/SendEventToAuthority"

headers = {"Content-Type": "application/json"}

payload = {
"status":"036",
"description":"Inscripcion",
"operationType":"361",
"valuePaid":"0",
"valueInvoice":"432000",
"IDEmisor":"900000000",
"IDEmisorTipo":"31",
"NombreEmisor":"EMPRESA EMISORA DE PRUEBA S.A.",
"InvoiceID":"SETP991010111",
"docType":"01",
"CUFEInvoice":"36bc2f7c4d018b3dcb8935129ec0fdf5f01bd7f1ff8867037766a837d73f1c51e9d1c3eaada76a94d6751de8ceeccdc6",
"IssueDate":"2023-01-03",
"EndDateInvoice":"2023-01-13"
}

response = requests.post(url, headers=headers, json=payload, auth=("username", "password"))

print(response.status_code)
print(response.json())

const axios = require('axios');

const url = 'https://developers-sbx.gosocket.net/api/v1/Document/SendEventToAuthority';

const config = {
  method: 'post',
  url: url,
  auth: {
    username: 'username',
    password: 'password'
  },
  data: {
"status":"036",
"description":"Inscripcion",
"operationType":"361",
"valuePaid":"0",
"valueInvoice":"432000",
"IDEmisor":"900000000",
"IDEmisorTipo":"31",
"NombreEmisor":"EMPRESA EMISORA DE PRUEBA S.A.",
"InvoiceID":"SETP991010111",
"docType":"01",
"CUFEInvoice":"36bc2f7c4d018b3dcb8935129ec0fdf5f01bd7f1ff8867037766a837d73f1c51e9d1c3eaada76a94d6751de8ceeccdc6",
"IssueDate":"2023-01-03",
"EndDateInvoice":"2023-01-13"
}
};

axios(config)
  .then(response => {
    console.log(response.status);
    console.log(JSON.stringify(response.data, null, 2));
  })
  .catch(error => {
    console.error(error);
  });

<?php

$url = "https://developers-sbx.gosocket.net/api/v1/Document/SendEventToAuthority";

$ch = curl_init($url);

curl_setopt($ch, CURLOPT_CUSTOMREQUEST, "POST");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);

curl_setopt($ch, CURLOPT_USERPWD, "username:password");

$data = json_encode({
"status":"036",
"description":"Inscripcion",
"operationType":"361",
"valuePaid":"0",
"valueInvoice":"432000",
"IDEmisor":"900000000",
"IDEmisorTipo":"31",
"NombreEmisor":"EMPRESA EMISORA DE PRUEBA S.A.",
"InvoiceID":"SETP991010111",
"docType":"01",
"CUFEInvoice":"36bc2f7c4d018b3dcb8935129ec0fdf5f01bd7f1ff8867037766a837d73f1c51e9d1c3eaada76a94d6751de8ceeccdc6",
"IssueDate":"2023-01-03",
"EndDateInvoice":"2023-01-13"
});
curl_setopt($ch, CURLOPT_POSTFIELDS, $data);

$response = curl_exec($ch);
$httpCode = curl_getinfo($ch, CURLINFO_HTTP_CODE);
curl_close($ch);

echo "Status: " . $httpCode . "\n";
echo $response;
?>

import java.net.http.*;
import java.net.URI;
import java.util.Base64;

public class ApiExample {
    public static void main(String[] args) throws Exception {
        String url = "https://developers-sbx.gosocket.net/api/v1/Document/SendEventToAuthority";

        HttpClient client = HttpClient.newHttpClient();
        HttpRequest.Builder requestBuilder = HttpRequest.newBuilder()
            .uri(URI.create(url))
            .method("POST", HttpRequest.BodyPublishers.ofString(
                """{
"status":"036",
"description":"Inscripcion",
"operationType":"361",
"valuePaid":"0",
"valueInvoice":"432000",
"IDEmisor":"900000000",
"IDEmisorTipo":"31",
"NombreEmisor":"EMPRESA EMISORA DE PRUEBA S.A.",
"InvoiceID":"SETP991010111",
"docType":"01",
"CUFEInvoice":"36bc2f7c4d018b3dcb8935129ec0fdf5f01bd7f1ff8867037766a837d73f1c51e9d1c3eaada76a94d6751de8ceeccdc6",
"IssueDate":"2023-01-03",
"EndDateInvoice":"2023-01-13"
}"""
            ));


        String auth = "username:password";
        String encodedAuth = Base64.getEncoder().encodeToString(auth.getBytes());
        requestBuilder.header("Authorization", "Basic " + encodedAuth);

        HttpRequest request = requestBuilder.build();
        HttpResponse<String> response = client.send(request,
            HttpResponse.BodyHandlers.ofString());

        System.out.println("Status: " + response.statusCode());
        System.out.println(response.body());
    }
}

const https = require('https');

const data = JSON.stringify({
  "status": "036",
  "description": "Inscripcion",
  "operationType": "361",
  "valuePaid": "0",
  "valueInvoice": "432000",
  "IDEmisor": "900000000",
  "IDEmisorTipo": "31",
  "NombreEmisor": "EMPRESA EMISORA DE PRUEBA S.A.",
  "InvoiceID": "SETP991010111",
  "docType": "01",
  "CUFEInvoice": "36bc2f7c4d018b3dcb8935129ec0fdf5f01bd7f1ff8867037766a837d73f1c51e9d1c3eaada76a94d6751de8ceeccdc6",
  "IssueDate": "2023-01-03",
  "EndDateInvoice": "2023-01-13"
});

const auth = Buffer.from('username:password').toString('base64');

const options = {
  hostname: 'developers-sbx.gosocket.net',
  path: '/api/v1/Document/SendEventToAuthority',
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Authorization': `Basic ${auth}`,
    'Content-Length': data.length
  }
};

const req = https.request(options, (res) => {
  let responseData = '';
  
  res.on('data', (chunk) => {
    responseData += chunk;
  });
  
  res.on('end', () => {
    console.log('Status:', res.statusCode);
    console.log('Response:', JSON.parse(responseData));
  });
});

req.on('error', (error) => {
  console.error('Error:', error);
});

req.write(data);
req.end();

require 'net/http'
require 'uri'
require 'json'

uri = URI.parse("https://developers-sbx.gosocket.net/api/v1/Document/SendEventToAuthority")

request = Net::HTTP::Post.new(uri)
request.basic_auth("username", "password")
request.content_type = "application/json"
request.body = JSON.dump({
  "status": "036",
  "description": "Inscripcion",
  "operationType": "361",
  "valuePaid": "0",
  "valueInvoice": "432000",
  "IDEmisor": "900000000",
  "IDEmisorTipo": "31",
  "NombreEmisor": "EMPRESA EMISORA DE PRUEBA S.A.",
  "InvoiceID": "SETP991010111",
  "docType": "01",
  "CUFEInvoice": "36bc2f7c4d018b3dcb8935129ec0fdf5f01bd7f1ff8867037766a837d73f1c51e9d1c3eaada76a94d6751de8ceeccdc6",
  "IssueDate": "2023-01-03",
  "EndDateInvoice": "2023-01-13"
})

req_options = {
  use_ssl: uri.scheme == "https",
}

response = Net::HTTP.start(uri.hostname, uri.port, req_options) do |http|
  http.request(request)
end

puts "Status: #{response.code}"
puts response.body

using System;
using System.Net.Http;
using System.Text;
using System.Threading.Tasks;

class Program
{
    static async Task Main()
    {
        var client = new HttpClient();
        var url = "https://developers-sbx.gosocket.net/api/v1/Document/SendEventToAuthority";
        
        // Basic Authentication
        var credentials = Convert.ToBase64String(Encoding.ASCII.GetBytes("username:password"));
        client.DefaultRequestHeaders.Authorization = 
            new System.Net.Http.Headers.AuthenticationHeaderValue("Basic", credentials);
        
        var json = @"{
  \"status\": \"036\",
  \"description\": \"Inscripcion\",
  \"operationType\": \"361\",
  \"valuePaid\": \"0\",
  \"valueInvoice\": \"432000\",
  \"IDEmisor\": \"900000000\",
  \"IDEmisorTipo\": \"31\",
  \"NombreEmisor\": \"EMPRESA EMISORA DE PRUEBA S.A.\",
  \"InvoiceID\": \"SETP991010111\",
  \"docType\": \"01\",
  \"CUFEInvoice\": \"36bc2f7c4d018b3dcb8935129ec0fdf5f01bd7f1ff8867037766a837d73f1c51e9d1c3eaada76a94d6751de8ceeccdc6\",
  \"IssueDate\": \"2023-01-03\",
  \"EndDateInvoice\": \"2023-01-13\"
}";
        var content = new StringContent(json, Encoding.UTF8, "application/json");
        
        var response = await client.PostAsync(url, content);
        var responseBody = await response.Content.ReadAsStringAsync();
        
        Console.WriteLine($"Status: {(int)response.StatusCode}");
        Console.WriteLine(responseBody);
    }
}

$url = "https://developers-sbx.gosocket.net/api/v1/Document/SendEventToAuthority"

$headers = @{
    "Content-Type" = "application/json"
}

$body = @'{
  "status": "036",
  "description": "Inscripcion",
  "operationType": "361",
  "valuePaid": "0",
  "valueInvoice": "432000",
  "IDEmisor": "900000000",
  "IDEmisorTipo": "31",
  "NombreEmisor": "EMPRESA EMISORA DE PRUEBA S.A.",
  "InvoiceID": "SETP991010111",
  "docType": "01",
  "CUFEInvoice": "36bc2f7c4d018b3dcb8935129ec0fdf5f01bd7f1ff8867037766a837d73f1c51e9d1c3eaada76a94d6751de8ceeccdc6",
  "IssueDate": "2023-01-03",
  "EndDateInvoice": "2023-01-13"
}'@

$credentials = "username:password"
$encodedCredentials = [Convert]::ToBase64String([Text.Encoding]::ASCII.GetBytes($credentials))
$headers["Authorization"] = "Basic $encodedCredentials"

try {
    $response = Invoke-RestMethod -Uri $url -Method Post -Headers $headers -Body $body
    Write-Host "Status: 200"
    Write-Host ($response | ConvertTo-Json -Depth 10)
} catch {
    Write-Host "Status: $($_.Exception.Response.StatusCode.value__)"
    Write-Host $_.Exception.Message
}

📋 Request Example (JSON)

{
  "status": "036",
  "description": "Inscripcion",
  "operationType": "361",
  "valuePaid": "0",
  "valueInvoice": "432000",
  "IDEmisor": "900000000",
  "IDEmisorTipo": "31",
  "NombreEmisor": "EMPRESA EMISORA DE PRUEBA S.A.",
  "InvoiceID": "SETP991010111",
  "docType": "01",
  "CUFEInvoice": "36bc2f7c4d018b3dcb8935129ec0fdf5f01bd7f1ff8867037766a837d73f1c51e9d1c3eaada76a94d6751de8ceeccdc6",
  "IssueDate": "2023-01-03",
  "EndDateInvoice": "2023-01-13"
}