Enviar nota débito para set de pruebas
Modo habilitación
Enviar nota débito
POST
https://isv.aliaddo.net/api/v1/public/documents/notes-db/habilitation/{testSetId}
Enviar una nota débito para set de pruebas en modo habilitación.
Path Parameters
Name
Type
Description
testSetId
string
Id de set de pruebas proporcionado por la DIAN para enviar documentos de prueba en modo habilitación para ser facturador electrónico
version
string
Versión de la API
Headers
Name
Type
Description
x-api-key
string
Token generado previamente para autorizarse
Request Body
Name
Type
Description
isvInvoiceNoteDb
object
Objeto de la nota débito
{
"id": "string",
"mode": "string",
"format": "string",
"emailSender": "string",
"testSetId": "string",
"concept": "string",
"prefix": "string",
"consecutive": 0,
"sequence": "string",
"externalNumber": "string",
"currencyCode": "string",
"currencyRate": 0.0,
"date": "2020-01-30T00:00:00",
"dateStart": "2020-01-30T00:00:00",
"dateEnd": "2020-01-31T00:00:00",
"typeOfOperation": "string",
"terms": "string",
"remark": "string",
"observation": "string",
"cufe": "string",
"qr": "string",
"urlPdf": "string",
"urlXmlDocument": "string",
"urlXmlDocumentZip": "string",
"urlXmlApplicationResponse": "string",
"urlXmlAttachedDocument": "string",
"UrlPdfEncoded": "string",
"UrlXmlEncoded": "string",
"dianDeliveryStatus": "string",
"dianState": "string",
"dianStateReason": "string",
"dianStateDate": "0001-01-01T00:00:00",
"sentEmailAt": "0001-01-01T00:00:00",
"invoicePrefix": "string",
"invoiceConsecutive": 0.0,
"invoiceCufe": "string",
"invoiceDate": "2020-01-18T00:00:00",
"branch": {
"name": "string",
"address": "string",
"phone": "string",
"countryCode": "string",
"countryName": "string",
"departamentCode": "string",
"departamentName": "string",
"cityCode": "string",
"cityName": "string"
},
"resolution": {
"resolutionKey": "string",
"resolutionPrefix": "string",
"resolutionNumber": 0.0,
"resolutionRangeInitial": 0.0,
"resolutionRangeFinal": 0.0,
"resolutionValidFrom": "2019-01-19T00:00:00",
"resolutionValidUntil": "2030-01-19T00:00:00"
},
"customer": {
"companyName": "string",
"personType": "string",
"regimeType": "string",
"firstName": "string",
"lastName": "string",
"identification": "string",
"digitCheck": "string",
"identificationTypeCode": "string",
"email": "string",
"phone": "string",
"merchantRegistration": "string",
"responsibilities": "string",
"economicActivitites": "string",
"billingAddress": "string",
"billingCountryName": "string",
"billingCountryCode": "string",
"billingRegionName": "string",
"billingRegionCode": "string",
"billingCityName": "string",
"billingCityCode": "string",
"billingPostalCode": "string",
"billingNeighborhood": "string",
"billingPhone": "string",
"billingContactName": "string",
"shippingAddress": "string",
"shippingCountryName": "string",
"shippingCountryCode": "string",
"shippingRegionName": "string",
"shippingRegionCode": "string",
"shippingCityName": "string",
"shippingCityCode": "string",
"shippingPostalCode": "string",
"shippingNeighborhood": "string",
"shippingPhone": "string",
"shippingContactName": "string"
},
"invoiceNoteDetails": [{
"standardType": "string",
"standardCode": "string",
"itemCode": "string",
"itemName": "string",
"itemModel": "string",
"description": "string",
"brandName": "string",
"itemCodeSupplier": "string",
"isPresent": false,
"unitMeasurementCode": "string",
"unitMeasurementName": "string",
"price": 0.0,
"quantity": 0.0,
"discountAmount": 0.0,
"chargeAmount": 0.0,
"subTotal": 0.0,
"priceWithAllowanceCharge": 0.0,
"totalWithAllowanceCharge": 0.0,
"discounts": [{
"name": "string",
"type": "string",
"rate": 0.0,
"amount": 0.0
}],
"charges": [{
"name": "string",
"type": "string",
"rate": 0.0,
"amount": 0.0
}],
"taxes": [{
"name": "string",
"code": "string",
"type": "string",
"rate": 0.0,
"amount": 0.0,
"base": 0.0
}],
"withholdings": [{
"name": "string",
"code": "string",
"type": "string",
"rate": 0.0,
"amount": 0.0,
"base": 0.0
}],
"isvMandante": {
"name": "string",
"identification": "string",
"digitCheck": "string",
"identificationTypeCode": "string"
}
}],
"totals": {
"amount": 0.0,
"prepaymentAmount": 0.0,
"taxesAmount": 0.0,
"withholdingAmount": 0.0,
"discountsAmount": 0.0,
"chargesAmount": 0.0
},
"discounts": [{
"name": "string",
"type": "string",
"rate": 0.0,
"amount": 0.0
}],
"charges": [{
"name": "string",
"type": "string",
"rate": 0.0,
"amount": 0.0
}],
"customFields": [{
"key": "string",
"value": "string"
}],
"invoiceConsecutiveWithPrefix": "string"
}
Código de ejemplo
using System;
using System.Collections.Generic;
using Newtonsoft.Json;
using RestSharp;
namespace App
{
public class Program
{
public static void Main()
{
/**
/notes-db/habilitation/{testSetId}:
- Enviar una nota débito para set de pruebas, en modo habilitación
- Instale RestSharp via Nuget: Install-Package RestSharp -Version 106.6.10
- Instale Newtonsoft via Nuget: Install-Package Newtonsoft.Json
*/
// Realizar request con TestId ejemplo 4bf6673a-7a71-496e-8cfd-f7246067e4ca, cambie este TestId por el que usted generó en la DIAN para habilitarse como facturador electrónico, si va realizar pruebas de conexión a la API puede realizarlo con el que esta en este ejemplo
// Realizar request por metodo POST
var request = new RestRequest("/notes-db/habilitation/4bf6673a-7a71-496e-8cfd-f7246067e4ca", Method.POST);
// Limpiar parametros
request.Parameters.Clear();
// Adicionar cabeceras de autenticación con token Bearer generado en el panel izquierdo
request.AddHeader("x-api-key", "{{x-api-key}}");
// Tipo de requerimiento formato json
request.AddHeader("content-type", "application/json");
request.AddHeader("cache-control", "no-cache");
request.AddHeader("accept", "application/json");
request.RequestFormat = DataFormat.Json;
// Adicionando objeto nota débito con resolución ejemplo
var isvInvoiceNoteDb = new
{
format = "Estandar",
emailSender = "",
concept = "1",
consecutive = 990000003,
externalNumber = "",
currencyCode = "COP",
currencyRate = 0,
date = "2020-1-18",
dateStart = "2020-1-18",
dateEnd = "2020-1-20",
typeOfOperation = "01",
terms = "",
remark = "",
observation = "",
invoicePrefix = "inv",
invoiceConsecutive = 990004331,
invoiceCufe = "aa2a047694318e5035cd93b3ffd5a12b829654c144b7cac0ac85ca5c0cb0430cfa3b477c4f7a75cf73f03f002f169162",
invoiceDate = "2020-1-18",
branch = new
{
name = "Sucursal",
address = "KR con CLL",
phone = "000000",
countryCode = "CO",
countryName = "COLOMBIA",
departamentCode = "25",
departamentName = "Cundinamarca",
cityCode = "25178",
cityName = "Chipaque"
},
resolution = new
{
resolutionKey = "fc8eac422eba16e22ffd8c6f94b3f40a6e38162c",
resolutionPrefix = "SETT",
resolutionNumber = 18760000001,
resolutionRangeInitial = 990000000,
resolutionRangeFinal = 995000000,
resolutionValidFrom = "2019-01-19",
resolutionValidUntil = "2030-01-19"
},
customer = new
{
companyName = "Customer",
personType = "1",
regimeType = "04",
firstName = "Customer",
lastName = "Customer",
identification = "000000001",
digitCheck = "8",
identificationTypeCode = "13",
email = "[email protected]",
phone = "0000001",
merchantRegistration = "",
responsibleFor = "ZZ",
responsibilities = "R-99-PN",
economicActivities = "2817;3092",
billingAddress = "KR con Calle",
billingCountryName = "Colombia",
billingCountryCode = "CO",
billingRegionName = "Cundinamarca",
billingRegionCode = "25",
billingCityName = "Chipaque",
billingCityCode = "25178",
billingPostalCode = "",
billingNeighborhood = "",
billingPhone = "",
billingContactName = "",
shippingAddress = "",
shippingCountryName = "",
shippingCountryCode = "",
shippingRegionName = "",
shippingRegionCode = "",
shippingCityName = "",
shippingCityCode = "",
shippingPostalCode = "",
shippingNeighborhood = "",
shippingPhone = "",
shippingContactName = ""
},
invoiceNoteDetails = new[]
{
new
{
standardType = "",
standardCode = "",
itemCode = "0001",
itemName = "Item",
itemModel = "",
description = "Item prueba",
brandName = "",
itemCodeSupplier = "",
isPresent = false,
unitMeasurementCode = "NIU",
unitMeasurementName = "",
price = 25,
quantity = 2,
discounts = new[]
{
new
{
name = "",
type = "V",
rate = 1,
amount = 1
}
},
charges = new[]
{
new
{
name = "",
type = "V",
rate = 10,
amount = 10
}
},
taxes = new[]
{
new
{
name = "Iva",
code = "01",
type = "P",
rate = 19,
amount = 6.46
}
},
withholdings = new[]
{
new
{
name = "ReteFuente",
code = "06",
type = "P",
rate = 10,
amount = 3.4
}
},
isvMandante = new
{
name = "Mandante",
identification = "001",
digitCheck = "8",
identificationTypeCode = "13"
}
}
},
totals = new
{
amount = 68,
prepaymentAmount = 0
},
discounts = new[]
{
new
{
name = "",
type = "",
rate = 0,
amount = 0
}
},
charges = new[]
{
new
{
name = "",
type = "V",
rate = 10,
amount = 10
}
},
customFields = new[]
{
new KeyValuePair<string, string>("NombreCampo", "ValorCampo")
}
};
request.AddParameter("application/json", JsonConvert.SerializeObject(isvInvoiceNoteDb),
ParameterType.RequestBody);
// Ejecutar request
var client = new RestClient("https://isv.aliaddo.net/api/v1/public/documents");
var response = client.Execute(request);
// Mostrar respuesta
Console.WriteLine((int) response.StatusCode);
Console.WriteLine(response.Content);
}
}
}
Última actualización
¿Te fue útil?