371 Con responsabilidad

POST

Endpoint

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

Autenticación

Tipo: Basic Auth

Basic Authentication con usuario y contraseña.

Cuerpo de la Solicitud

Descripción

Campo	Tipo	Requerido	Descripción	Ejemplo
status	string	✅ Sí	-	037
description	string	✅ Sí	-	Endoso en Propiedad
operationType	string	✅ Sí	-	371
IDEmisor	string	✅ Sí	-	900508908
IDEmisorTipo	string	✅ Sí	-	31
NombreEmisor	string	✅ Sí	-	Signature South Consulting
IDEndosatario	string	✅ Sí	-	890900608
NombreEndosatario	string	✅ Sí	-	Éxito Viajes y Turismo
TipoEndoso	string	✅ Sí	-	1
valuePaid	string	✅ Sí	-	0
valueInvoice	string	✅ Sí	-	432000
PrecioPagarseEn...	string	✅ Sí	-	14500
TasaDescuentoEn...	string	✅ Sí	-	5
MedioPago	string	✅ Sí	-	ZZZ
Moneda	string	✅ Sí	-	COP
InvoiceID	string	✅ Sí	-	SETP994002551
docType	string	✅ Sí	-	01
CUFEInvoice	hash	✅ Sí	-	3f0f41655f674f08a59ae541add8
IDReceptor	string	✅ Sí	-	890900608
IDReceptorTipo	string	✅ Sí	-	31
NombreReceptor	string	✅ Sí	-	ALMACENES EXITO S A
IssueDate	date	✅ Sí	-	2022-12-05
EndDateInvoice	date	✅ Sí	-	2022-12-30

Ejemplos de Código

🔧 cURL

curl -X POST 'https://developers.gosocket.net/sandbox/api/v1/Document/SendEventToAuthority' \
  -u 'username:password' \
  -d '{
  "status": "037",
  "description": "Endoso en Propiedad",
  "operationType": "371",
  "IDEmisor": "900508908",
  "IDEmisorTipo": "31",
  "NombreEmisor": "Signature South Consulting",
  "IDEndosatario": "890900608",
  "NombreEndosatario": "Éxito Viajes y Turismo",
  "TipoEndoso": "1",
  "valuePaid": "0",
  "valueInvoice": "432000",
  "PrecioPagarseEndoso": "14500",
  "TasaDescuentoEndoso": "5",
  "MedioPago": "ZZZ",
  "Moneda": "COP",
  "InvoiceID": "SETP994002551",
  "docType": "01",
  "CUFEInvoice": "3f0f41655f674f08a59ae541add81e043c77d4331a469fc82bfa1f7f7c5c57d22dd417d6b2258240bd3119d485120b07",
  "IDReceptor": "890900608",
  "IDReceptorTipo": "31",
  "NombreReceptor": "ALMACENES EXITO S A",
  "IssueDate": "2022-12-05",
  "EndDateInvoice": "2022-12-30"
}'

🐍 Python

import requests
import json

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

payload = {
"status":"037",
"description":"Endoso en Propiedad",
"operationType":"371",
"IDEmisor":"900508908",
"IDEmisorTipo":"31",
"NombreEmisor":"Signature South Consulting",
"IDEndosatario":"890900608",
"NombreEndosatario":"Éxito Viajes y Turismo",
"TipoEndoso":"1",
"valuePaid":"0",
"valueInvoice":"432000",
"PrecioPagarseEndoso":"14500",
"TasaDescuentoEndoso":"5",
"MedioPago":"ZZZ",
"Moneda":"COP",
"InvoiceID":"SETP994002551",
"docType":"01",
"CUFEInvoice":"3f0f41655f674f08a59ae541add81e043c77d4331a469fc82bfa1f7f7c5c57d22dd417d6b2258240bd3119d485120b07",
"IDReceptor":"890900608",
"IDReceptorTipo":"31",
"NombreReceptor":"ALMACENES EXITO S A",
"IssueDate":"2022-12-05",
"EndDateInvoice":"2022-12-30"
}

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

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

⚡ JavaScript

const axios = require('axios');

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

const config = {
  method: 'post',
  url: url,
  auth: {
    username: 'username',
    password: 'password'
  },
  data: {
"status":"037",
"description":"Endoso en Propiedad",
"operationType":"371",
"IDEmisor":"900508908",
"IDEmisorTipo":"31",
"NombreEmisor":"Signature South Consulting",
"IDEndosatario":"890900608",
"NombreEndosatario":"Éxito Viajes y Turismo",
"TipoEndoso":"1",
"valuePaid":"0",
"valueInvoice":"432000",
"PrecioPagarseEndoso":"14500",
"TasaDescuentoEndoso":"5",
"MedioPago":"ZZZ",
"Moneda":"COP",
"InvoiceID":"SETP994002551",
"docType":"01",
"CUFEInvoice":"3f0f41655f674f08a59ae541add81e043c77d4331a469fc82bfa1f7f7c5c57d22dd417d6b2258240bd3119d485120b07",
"IDReceptor":"890900608",
"IDReceptorTipo":"31",
"NombreReceptor":"ALMACENES EXITO S A",
"IssueDate":"2022-12-05",
"EndDateInvoice":"2022-12-30"
}
};

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

🐘 PHP

<?php

$url = "https://developers.gosocket.net/sandbox/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":"037",
"description":"Endoso en Propiedad",
"operationType":"371",
"IDEmisor":"900508908",
"IDEmisorTipo":"31",
"NombreEmisor":"Signature South Consulting",
"IDEndosatario":"890900608",
"NombreEndosatario":"Éxito Viajes y Turismo",
"TipoEndoso":"1",
"valuePaid":"0",
"valueInvoice":"432000",
"PrecioPagarseEndoso":"14500",
"TasaDescuentoEndoso":"5",
"MedioPago":"ZZZ",
"Moneda":"COP",
"InvoiceID":"SETP994002551",
"docType":"01",
"CUFEInvoice":"3f0f41655f674f08a59ae541add81e043c77d4331a469fc82bfa1f7f7c5c57d22dd417d6b2258240bd3119d485120b07",
"IDReceptor":"890900608",
"IDReceptorTipo":"31",
"NombreReceptor":"ALMACENES EXITO S A",
"IssueDate":"2022-12-05",
"EndDateInvoice":"2022-12-30"
});
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;
?>

☕ Java

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.gosocket.net/sandbox/api/v1/Document/SendEventToAuthority";

        HttpClient client = HttpClient.newHttpClient();
        HttpRequest.Builder requestBuilder = HttpRequest.newBuilder()
            .uri(URI.create(url))
            .method("POST", HttpRequest.BodyPublishers.ofString(
                """{
"status":"037",
"description":"Endoso en Propiedad",
"operationType":"371",
"IDEmisor":"900508908",
"IDEmisorTipo":"31",
"NombreEmisor":"Signature South Consulting",
"IDEndosatario":"890900608",
"NombreEndosatario":"Éxito Viajes y Turismo",
"TipoEndoso":"1",
"valuePaid":"0",
"valueInvoice":"432000",
"PrecioPagarseEndoso":"14500",
"TasaDescuentoEndoso":"5",
"MedioPago":"ZZZ",
"Moneda":"COP",
"InvoiceID":"SETP994002551",
"docType":"01",
"CUFEInvoice":"3f0f41655f674f08a59ae541add81e043c77d4331a469fc82bfa1f7f7c5c57d22dd417d6b2258240bd3119d485120b07",
"IDReceptor":"890900608",
"IDReceptorTipo":"31",
"NombreReceptor":"ALMACENES EXITO S A",
"IssueDate":"2022-12-05",
"EndDateInvoice":"2022-12-30"
}"""
            ));


        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());
    }
}

🟢 Node.js

const https = require('https');

const data = JSON.stringify({
  "status": "037",
  "description": "Endoso en Propiedad",
  "operationType": "371",
  "IDEmisor": "900508908",
  "IDEmisorTipo": "31",
  "NombreEmisor": "Signature South Consulting",
  "IDEndosatario": "890900608",
  "NombreEndosatario": "Éxito Viajes y Turismo",
  "TipoEndoso": "1",
  "valuePaid": "0",
  "valueInvoice": "432000",
  "PrecioPagarseEndoso": "14500",
  "TasaDescuentoEndoso": "5",
  "MedioPago": "ZZZ",
  "Moneda": "COP",
  "InvoiceID": "SETP994002551",
  "docType": "01",
  "CUFEInvoice": "3f0f41655f674f08a59ae541add81e043c77d4331a469fc82bfa1f7f7c5c57d22dd417d6b2258240bd3119d485120b07",
  "IDReceptor": "890900608",
  "IDReceptorTipo": "31",
  "NombreReceptor": "ALMACENES EXITO S A",
  "IssueDate": "2022-12-05",
  "EndDateInvoice": "2022-12-30"
});

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

const options = {
  hostname: 'developers.gosocket.net',
  path: '/sandbox/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();

💎 Ruby

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

uri = URI.parse("https://developers.gosocket.net/sandbox/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": "037",
  "description": "Endoso en Propiedad",
  "operationType": "371",
  "IDEmisor": "900508908",
  "IDEmisorTipo": "31",
  "NombreEmisor": "Signature South Consulting",
  "IDEndosatario": "890900608",
  "NombreEndosatario": "Éxito Viajes y Turismo",
  "TipoEndoso": "1",
  "valuePaid": "0",
  "valueInvoice": "432000",
  "PrecioPagarseEndoso": "14500",
  "TasaDescuentoEndoso": "5",
  "MedioPago": "ZZZ",
  "Moneda": "COP",
  "InvoiceID": "SETP994002551",
  "docType": "01",
  "CUFEInvoice": "3f0f41655f674f08a59ae541add81e043c77d4331a469fc82bfa1f7f7c5c57d22dd417d6b2258240bd3119d485120b07",
  "IDReceptor": "890900608",
  "IDReceptorTipo": "31",
  "NombreReceptor": "ALMACENES EXITO S A",
  "IssueDate": "2022-12-05",
  "EndDateInvoice": "2022-12-30"
})

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

🔷 C#

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.gosocket.net/sandbox/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\": \"037\",
  \"description\": \"Endoso en Propiedad\",
  \"operationType\": \"371\",
  \"IDEmisor\": \"900508908\",
  \"IDEmisorTipo\": \"31\",
  \"NombreEmisor\": \"Signature South Consulting\",
  \"IDEndosatario\": \"890900608\",
  \"NombreEndosatario\": \"Éxito Viajes y Turismo\",
  \"TipoEndoso\": \"1\",
  \"valuePaid\": \"0\",
  \"valueInvoice\": \"432000\",
  \"PrecioPagarseEndoso\": \"14500\",
  \"TasaDescuentoEndoso\": \"5\",
  \"MedioPago\": \"ZZZ\",
  \"Moneda\": \"COP\",
  \"InvoiceID\": \"SETP994002551\",
  \"docType\": \"01\",
  \"CUFEInvoice\": \"3f0f41655f674f08a59ae541add81e043c77d4331a469fc82bfa1f7f7c5c57d22dd417d6b2258240bd3119d485120b07\",
  \"IDReceptor\": \"890900608\",
  \"IDReceptorTipo\": \"31\",
  \"NombreReceptor\": \"ALMACENES EXITO S A\",
  \"IssueDate\": \"2022-12-05\",
  \"EndDateInvoice\": \"2022-12-30\"
}";
        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);
    }
}

💠 PowerShell

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

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

$body = @'{
  "status": "037",
  "description": "Endoso en Propiedad",
  "operationType": "371",
  "IDEmisor": "900508908",
  "IDEmisorTipo": "31",
  "NombreEmisor": "Signature South Consulting",
  "IDEndosatario": "890900608",
  "NombreEndosatario": "Éxito Viajes y Turismo",
  "TipoEndoso": "1",
  "valuePaid": "0",
  "valueInvoice": "432000",
  "PrecioPagarseEndoso": "14500",
  "TasaDescuentoEndoso": "5",
  "MedioPago": "ZZZ",
  "Moneda": "COP",
  "InvoiceID": "SETP994002551",
  "docType": "01",
  "CUFEInvoice": "3f0f41655f674f08a59ae541add81e043c77d4331a469fc82bfa1f7f7c5c57d22dd417d6b2258240bd3119d485120b07",
  "IDReceptor": "890900608",
  "IDReceptorTipo": "31",
  "NombreReceptor": "ALMACENES EXITO S A",
  "IssueDate": "2022-12-05",
  "EndDateInvoice": "2022-12-30"
}'@

$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
}

📋 Ejemplo de Request (JSON)

{
  "status": "037",
  "description": "Endoso en Propiedad",
  "operationType": "371",
  "IDEmisor": "900508908",
  "IDEmisorTipo": "31",
  "NombreEmisor": "Signature South Consulting",
  "IDEndosatario": "890900608",
  "NombreEndosatario": "Éxito Viajes y Turismo",
  "TipoEndoso": "1",
  "valuePaid": "0",
  "valueInvoice": "432000",
  "PrecioPagarseEndoso": "14500",
  "TasaDescuentoEndoso": "5",
  "MedioPago": "ZZZ",
  "Moneda": "COP",
  "InvoiceID": "SETP994002551",
  "docType": "01",
  "CUFEInvoice": "3f0f41655f674f08a59ae541add81e043c77d4331a469fc82bfa1f7f7c5c57d22dd417d6b2258240bd3119d485120b07",
  "IDReceptor": "890900608",
  "IDReceptorTipo": "31",
  "NombreReceptor": "ALMACENES EXITO S A",
  "IssueDate": "2022-12-05",
  "EndDateInvoice": "2022-12-30"
}