1. DianServices
Documentación Bilidox
  • ¡Bienvenido!
  • Raíz
    • DianServices
      • NumberingRangeGetAll
        GET
      • StatusZipGetAll
        GET
      • SendMailCreate
        POST
      • TestSetCreate
        POST
      • InvoiceCreate
        POST
      • CreditnoteCreate
        POST
      • EquivalentCreate
        POST
      • EquivalentSpdCreate
        POST
      • SupportCreate
        POST
      • PayrollCreate
        POST
      • EventCreate
        POST
      • DebitnoteCreate
        POST
      • EquivalentNoteCreate
        POST
      • SupportNoteCreate
        POST
      • PayrollReplaceNote
        POST
      • PayrollDeleteNote
        POST
    • S3File
      • fileUrlGetItem
      • filePdfGetItem
      • fileXmlGetItem
  1. DianServices

PayrollCreate

POST
/v1/dian/payroll-documents/
💡
Endpoint que permite crear una Documento soporte de pago de nómina electrónica, con los datos requeridos para enviar a la DIAN.
💡
Method: POST
Crear un Documento soporte de pago de nómina electrónica

Solicitud

Autorización
Proporciona tu token bearer en el encabezado
Authorization
al realizar solicitudes a recursos protegidos.
Ejemplo:
Authorization: Bearer ********************
Parámetros de consulta

Parámetros del Body application/json

Ejemplos

Respuestas

🟢200
application/json
Bodyapplication/json

Solicitud Ejemplo de Solicitud
Shell
JavaScript
Java
Swift
curl --location '/v1/dian/payroll-documents/?companyId=901084328&providerId=901084328' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
  "TypeCode": "102",
  "Number": 193,
  "Date": "2024-02-12T16:55:25.487",
  "Note": "",
  "NumberingRange": {
    "Id": 0,
    "Date": "2021-10-01T00:00:00",
    "Prefix": "DSNE",
    "FromNumber": 1,
    "ToNumber": 100000,
    "TechnicalKey": "",
    "StartDate": "2021-10-01T00:00:00",
    "EndDate": "2050-12-31T00:00:00"
  },
  "SoftwareProvider": {
    "Origin": "software_emisor"
  },
  "SigningCertificate": {
    "Password": "",
    "Content": "",
  },
  "CompanyParty": {
    "ImageUrl": null,
    "Id": "000000000",
    "IdentificationType": "31",
    "Name": "PEMPRESA SAS",
    "PhysicalLocation": {
      "Address": "",
      "CityCode": "54001",
      "SubentityCode": "54",
      "CountryCode": "CO",
      "CountryName": ""
    },
    "Email": "contacto@miempresa.com",
    "Phone": "0000000000"
  },
  "EmployeeParty": {
    "Id": "1095786063",
    "IdentificationType": "13",
    "Code": "364247",
    "TypeCode": "01",
    "SubtypeCode": "00",
    "IsPensionRisk": false,
    "FirstName": "Nombre1",
    "MiddleName": "Nombre2",
    "FirstSurname": "Apellido1",
    "SecondSurname": "Apellido2",
    "ContractType": "2",
    "IsIntegralSalary": true,
    "SalaryAmount": 1800000.00,
    "PhysicalLocation": {
      "Address": "CR 0 CL 0",
      "CityCode": "68276",
      "SubentityCode": "68",
      "CountryCode": "CO"
    },
    "Email": "empleado@miempresa.com",
    "Phone": "0000000000"
  },
  "Information": {
    "Date": "2024-02-12T16:55:25.487",
    "Address": "CR 0 CL 0",
    "CurrencyCode": "COP",
    "CurrencyBaseRate": 1.0,
    "PeriodCode": "4"
  },
  "Period": {
    "EntryDate": "2023-11-16T00:00:00",
    "FinishDate": null,
    "StartDate": "2024-01-01T00:00:00",
    "EndDate": "2024-01-31T00:00:00",
    "TimeWorkedDays": 76
  },
  "Pay": {
    "Code": "1",
    "Date": "2024-01-31T00:00:00",
    "MethodCode": "31"
  },
  "Account": {
    "Bank": "",
    "Type": "Ahorros",
    "Number": ""
  },
  "Items": [
    {
      "Type": "Devengo",
      "code": "Basico",
      "Quantity": 15.00,
      "Description": "",
      "StartDate": "0001-01-01T00:00:00",
      "EndDate": "0001-01-01T00:00:00",
      "Amount": 900000.00,
      "InhabilityCode": "0",
      "IsSalary": false
    },
    {
      "Type": "Devengo",
      "code": "Transporte",
      "Quantity": 15.00,
      "Description": "",
      "StartDate": "0001-01-01T00:00:00",
      "EndDate": "0001-01-01T00:00:00",
      "Amount": 81000.00,
      "InhabilityCode": "0",
      "IsSalary": false
    },
    {
      "Type": "Deduccion",
      "code": "Salud",
      "Quantity": 1.00,
      "Description": "",
      "StartDate": "0001-01-01T00:00:00",
      "EndDate": "0001-01-01T00:00:00",
      "Amount": 36000.00,
      "InhabilityCode": "0",
      "IsSalary": false
    },
    {
      "Type": "Deduccion",
      "code": "FondoPension",
      "Quantity": 1.00,
      "Description": "",
      "StartDate": "0001-01-01T00:00:00",
      "EndDate": "0001-01-01T00:00:00",
      "Amount": 36000.00,
      "InhabilityCode": "0",
      "IsSalary": false
    }
  ],
  "CustomizePrintFormat": {
    "HeaderText": "",
    "FooterText": ""
  },
  "MonetaryTotal": {
    "PayableAmount": 1962000.0,
    "DiscountAmount": 144000.0,
    "TotalAmount": 1818000.0
  }
}'
Respuesta Ejemplo de Respuesta
{
  "id": "DSNE238",
  "name": "face_fDSN09010843280000000238",
  "status": "submitted",
  "created": "2024-04-05T08:48:00.909+00:00",
  "document": {
    "uuid": "a5b8f21175a2f8d4330992b96d521d56364bfc1f611886897d6c9ccaa1f0b626c37da471fe83b62510a706b8b13907d7",
    "date": "2024-04-05T08:47:55.7+00:00",
    "type": "102",
    "number": 238,
    "prefix": "DSNE",
    "schemeName": "CUNE-SHA384",
    "signatureValue": "P3Dp4lgRLiI9rCiTpZpItfhDTZysKi0ElO6zgiEGcGBbaOhfeIswSwoxLK3Xf9Ot5z2syzKlHEcUpOUt8tV92am0fKCwARm2Oq2WJC2GdyRMKBjkuqo41nkOMxIs7849mkiik21P2GwBB3sKX0gRlkszTaxIeBzeAeN7j+YJJ2SraYNd5st4NY7x45l/SQbazGh2zUerNsLuWibbnCSMJJzEkCjaFdtce55n/wZuuK3OBRAyhtxbAe6HhlabmbZow7olKYtwrEdsFl4Zivig0SUlVIdMvq5IFFiEXxHez/Umy+hQfScKTVuQ0F0cS0xDOkULMgYuRBd1wcGeZ5CMVw==",
    "reference": ""
  },
  "response": {
    "statusCode": "00",
    "statusMessage": "La Nomina Individual DSNE238, ha sido autorizada.",
    "statusDescription": "Procesado Correctamente.",
    "errorMessage": "",
    "zipkey": ""
  }
}
Modificado en 2026-09-14 14:06:05
Anterior
SupportCreate
Siguiente
EventCreate
Built with