Objeto Notas de Crédito y Débito

Puedes hacer uso de la API para solicitar la información de uno o más notas de crédito y/o débito de tu empresa.

Método getNotes

Método para obtener una lista de notas de credito y/o débito de la empresa de acuerdo a parámetros definidos.

Parámetro Descripción
Método GET
URL https://api.duemint.com/v1/getNotes<params>
Params Parámetros que pueden ser agregados a la solicitud para discriminar qué notas se desea obtener. Los parametros posibles son:
since date Fecha desde cuando contar los documentos en formato YYYY-MM-DD, con respecto a la fecha definida en el parámetro dateBy
until date Fecha hasta cuando contar los documentos en formato YYYY-MM-DD, con respecto a la fecha definida en el parámetro dateBy
dateBy integer 1 = Fecha de emisión (por defecto); 2 = Fecha de creación
type boolean Tipo de la nota. 0: Crédito; 1: Débito
number string Folio o número del documento
code integer Código tributario del documento. 56: Nota de Débito Electrónica; 61: Nota de Crédito Electrónica
currency string(3) Código ISO de la moneda que se desea filtrar. Por ejemplo USD para Dólar Americano o CLP para Pesos Chilenos
documentId integer Id único del documento (factura) de referencia al que se encuentra asociada la Nota. Ver getDocuments
clientId integer Id único del cliente. Ver getClients
clientTaxId string Código tributario del cliente. En el caso de un RUT chileno el formato es sin puntos y con guión (ej: 99999999-9)
orderBy integer 1: Fecha de emisión (por defecto); 2: Fecha de creación; 3: Número o folio; 4: Monto total
order string ASC o DESC (default)
resultsPerPage integer Número de resultados por solicitud. Por defecto = 50 (máximo 100)
page integer Página de resultados. Por defecto = 1
expandFile bool 0: No expandir (Por defecto), 1: Expandir información del archivo

A continuación se muestra un ejemplo usando el método getNotes de la API de Duemint.

METHOD GET
curl "https://api.duemint.com/v1/getNotes?clientId=8201&resultsPerPage=2" \
 -H 'Authorization: Bearer <token>' -H 'Accept: application/json'

El resultado ejemplo para esta llamada se muestra a continuación:

{
  "records": {
    "totalRecords": 7,
    "items": 2,
    "page": 1,
    "pages": 4
  },
  "items": [
    {
      "id": "2607",
      "clientTaxId": "99999999-9",
      "number": "22",
      "createdAt": "2018-04-11 21:02:36",
      "issueDate": "2018-04-11",
      "code": 61,
      "type": false,
      "typeName": "Cr\u00e9dito",
      "currency": "CLP",
      "net": "26967.00",
      "taxes": "5124.00",
      "total": "32091.00",
      "gloss": "",
      "notes": "*** REFERENCIAS DTE ***\r\n\r\nTpoDocRef: 33\r\nFolioRef: 659\r\nFchRef: 2018-04-06\r\n\r\n*** LINEAS DETALLE DTE ***\r\n\r\nNroLinDet: 1\r\nNmbItem: Plan 1 UF - Mar 2018\r\nDscItem: UF SII 06 Abr 2018: 26966.89 CLP\r\nQtyItem: 1.00\r\nPrcItem: 26966.89\r\nMontoItem: 26967\r\n\r\n",
      "client": {
        "id": "8201"
      },
      "document": {
        "id": "106221"
      },
      "files": []
    },
    {
      "id": "2295",
      "clientTaxId": "99999999-9",+
      "number": "21",
      "createdAt": "2018-03-29 21:21:09",
      "issueDate": "2018-03-29",
      "code": 61,
      "type": false,
      "typeName": "Cr\u00e9dito",
      "currency": "CLP",
      "net": "23487.00",
      "taxes": "4463.00",
      "total": "27950.00",
      "gloss": "",
      "notes": "",
      "client": {
        "id": "8201"
      },
      "document": {
        "id": "97790"
      },
      "files": []
    }
  ]
}

Método getNote

Método para obtener una nota de crédito o débito específica.

Parámetro Descripción
Método GET
URL https://api.duemint.com/v1/getNote<params>
Params Parámetros que pueden ser agregados a la solicitud para discriminar qué nota se desea obtener. Los parametros posibles son:
id integer Id único de la nota de crédito o débito (requerido)
expandFile bool 0: No expandir (Por defecto), 1: Expandir información del archivo

A continuación se muestra un ejemplo usando el método getNote de la API de Duemint.

METHOD GET
curl "https://api.duemint.com/v1/getNote?id=2607" \
 -H 'Authorization: Bearer <token>' -H 'Accept: application/json'

El resultado ejemplo para esta llamada se muestra a continuación:

{
  "id": "2607",
  "clientTaxId": "99999999-9",
  "number": "22",
  "createdAt": "2018-04-11 21:02:36",
  "issueDate": "2018-04-11",
  "code": 61,
  "type": false,
  "typeName": "Cr\u00e9dito",
  "currency": "CLP",
  "net": "26967.00",
  "taxes": "5124.00",
  "total": "32091.00",
  "gloss": "",
  "notes": "*** REFERENCIAS DTE ***\r\n\r\nTpoDocRef: 33\r\nFolioRef: 659\r\nFchRef: 2018-04-06\r\n\r\n*** LINEAS DETALLE DTE ***\r\n\r\nNroLinDet: 1\r\nNmbItem: Plan 1 UF - Mar 2018\r\nDscItem: UF SII 06 Abr 2018: 26966.89 CLP\r\nQtyItem: 1.00\r\nPrcItem: 26966.89\r\nMontoItem: 26967\r\n\r\n",
  "client": {
    "id": "8201"
  },
  "document": {
    "id": "106221"
  },
  "files": []
}

Método createNoteFromXml

Método para crear una Nota de crédito o Débito a partir de un XML debidamente estructurado de acuerdo a su País.

Parámetro Descripción
Método POST
URL https://api.duemint.com/v1/createNoteFromXml
Post Params Parametros a comunicar.
xml string Cadena de texto correspondiente al xml codificado en base64. Los DTE aceptados en este método deben ser Facturas Electrónicas (33) o Facturas Exentas Electrónicas (34). (requerido)
countryCode string Código ISO de 2 letras del país (por defecto CL). Por ejemplo CL para Chile, MX para México.

A continuación se muestra un ejemplo usando el método createNoteFromXml de la API de Duemint.

METHOD POST
curl "https://api.duemint.com/v1/createNoteFromXml' -X POST \
 -d '{"xml":"PERURSB2ZXJzaW9uPSIxLjAiPgo8RG9jdW1lbnRvIElEPSJNaVBFNzY0NTM3MDctMiI+CiAgICA8RW5jYWJlemFkbz4KICAgICAgPElkRG9jPgogICAgICAgIDxUaXBvRFRFPjMzPC9UaXBvRFRFPgogICAgICAgIDxGb2xpbz42OTY8L0ZvbGlvPgogICAgICAgIDxGY2hFbWlzPjIwMTgtMDQtMDY8L0ZjaEVtaXM+CiAgICAgICAgPFRwb1RyYW5Db21wcmE+MTwvVHBvVHJhbkNvbXByYT4KICAgICAgICA8VHBvVHJhblZlbnRhPjE8L1Rwb1RyYW5WZW50YT4KICAgICAgICA8Rm1hUGFnbz4yPC9GbWFQYWdvPgogICAgICA8L0lkRG9jPgogICAgICA8RW1pc29yPgogICAgICAgIDxSVVRFbWlzb3I+NzY0NTM3MDctNjwvUlVURW1pc29yPgogICAgICAgIDxSem5Tb2M+RFVFTUlOVCBTUEE8L1J6blNvYz4KICAgICAgICA8R2lyb0VtaXM+REVTQVJST0xMTyBZIFZFTlRBIERFIFNPRlRXQVJFUywgU0lTVEVNQVMgWSBBUFBTPC9HaXJvRW1pcz4KICAgICAgICA8Q29ycmVvRW1pc29yPlBBQkxPQERVRU1JTlQuQ09NPC9Db3JyZW9FbWlzb3I+CiAgICAgICAgPEFjdGVjbz43MjQwMDA8L0FjdGVjbz4KICAgICAgICA8Q2RnU0lJU3VjdXI+MDgwNTYxOTU1PC9DZGdTSUlTdWN1cj4KICAgICAgICA8RGlyT3JpZ2VuPkFWLiBMT1MgRE9NSU5JQ09TIDg2MzAgIDMxMDwvRGlyT3JpZ2VuPgogICAgICAgIDxDbW5hT3JpZ2VuPkxBUyBDT05ERVM8L0NtbmFPcmlnZW4+CiAgICAgICAgPENpdWRhZE9yaWdlbj5TQU5USUFHTzwvQ2l1ZGFkT3JpZ2VuPgogICAgICA8L0VtaXNvcj4KICAgICAgPFJlY2VwdG9yPgogICAgICAgIDxSVVRSZWNlcD45OTk5OTk5OS05PC9SVVRSZWNlcD4KICAgICAgICA8UnpuU29jUmVjZXA+Q0xJRU5URSBFSkVNUExPPC9Sem5Tb2NSZWNlcD4KICAgICAgICA8R2lyb1JlY2VwPlZFTlRBIEFMIFBPUiBNQVlPUiBERSBIVUVWT1MsIExFQ0hFPC9HaXJvUmVjZXA+CiAgICAgICAgPERpclJlY2VwPkFWIExBUyBDT05ERVMgNjkwMzwvRGlyUmVjZXA+CiAgICAgICAgPENtbmFSZWNlcD5MQVMgQ09OREVTPC9DbW5hUmVjZXA+CiAgICAgICAgPENpdWRhZFJlY2VwPlNBTlRJQUdPPC9DaXVkYWRSZWNlcD4KICAgICAgPC9SZWNlcHRvcj4KICAgICAgPFRvdGFsZXM+CiAgICAgICAgPE1udE5ldG8+ODA5MDE8L01udE5ldG8+CiAgICAgICAgPFRhc2FJVkE+MTkuMDA8L1Rhc2FJVkE+CiAgICAgICAgPElWQT4xNTM3MTwvSVZBPgogICAgICAgIDxNbnRUb3RhbD45NjI3MjwvTW50VG90YWw+CiAgICAgIDwvVG90YWxlcz4KICAgIDwvRW5jYWJlemFkbz4KICAgIDxEZXRhbGxlPgogICAgICA8TnJvTGluRGV0PjE8L05yb0xpbkRldD4KICAgICAgPE5tYkl0ZW0+U0VSVklDSU9TIFZBUklPUzwvTm1iSXRlbT4KICAgICAgPERzY0l0ZW0+Q09OU1VMVE9SSUEgWSBBU0VTT1JJQTwvRHNjSXRlbT4KICAgICAgPFF0eUl0ZW0+MS4wMDwvUXR5SXRlbT4KICAgICAgPFVubWRJdGVtPnVuaTwvVW5tZEl0ZW0+CiAgICAgIDxQcmNJdGVtPjgwOTAwLjY3PC9QcmNJdGVtPgogICAgICA8TW9udG9JdGVtPjgwOTAxPC9Nb250b0l0ZW0+CiAgICA8L0RldGFsbGU+CiAgPC9Eb2N1bWVudG8+CjwvRFRFPg=="}'
 -H 'Authorization: Bearer <token>' -H 'Accept: application/json'

El resultado ejemplo para esta llamada se muestra a continuación:

{
  "id": "2607",
  "clientTaxId": "99999999-9",
  "number": "22",
  "createdAt": "2018-04-11 21:02:36",
  "issueDate": "2018-04-11",
  "code": 61,
  "type": false,
  "typeName": "Cr\u00e9dito",
  "currency": "CLP",
  "net": "26967.00",
  "taxes": "5124.00",
  "total": "32091.00",
  "gloss": "",
  "notes": "*** REFERENCIAS DTE ***\r\n\r\nTpoDocRef: 33\r\nFolioRef: 659\r\nFchRef: 2018-04-06\r\n\r\n*** LINEAS DETALLE DTE ***\r\n\r\nNroLinDet: 1\r\nNmbItem: Plan 1 UF - Mar 2018\r\nDscItem: UF SII 06 Abr 2018: 26966.89 CLP\r\nQtyItem: 1.00\r\nPrcItem: 26966.89\r\nMontoItem: 26967\r\n\r\n",
  "client": {
    "id": "8201"
  },
  "document": {
    "id": "106221"
  },
  "files": []
}

Método createNote

Método para crear una Nota de Crédito o Débito. Si tienes acceso al XML te recomendamos utilizar el método createNoteFromXml.

Parámetro Descripción
Método POST
URL https://api.duemint.com/v1/createNote
Post Params Parametros a comunicar
documentId integer Id único del documento (factura) de referencia al que se encuentra asociada la Nota (requerido)
number string Número o folio de la Nota (requerido)
issueDate date YYYY-MM-DD Fecha de emisión de la Nota (requerido)
type boolean 0: Crédito; 1: Débito (requerido)
total float Monto total de la Nota (requerido)
taxes float Monto de impuestos de la Nota (requerido)
code integer Código tributario del documento (56: Nota de Débito Electrónica; 61: Nota de Crédito Electrónica)
currency string(3) Código ISO de la moneda del documento. Por ejemplo USD para Dólar Americano o CLP para Pesos Chilenos
gloss string(255) Glosa (descripción) del documento
notes string Notas (descripción detalla) del documento

A continuación se muestra un ejemplo usando el método createNote de la API de Duemint.

METHOD POST
curl "https://api.duemint.com/v1/createNote' -X POST \
 -d '{"documentId":"106221","number":"22","issueDate":"2018-04-11","type":"0","total":"32091","taxes":"5124","currency":"CLP"}'
 -H 'Authorization: Bearer <token>' -H 'Accept: application/json'

El resultado ejemplo para esta llamada se muestra a continuación:

{
  "id": "2607",
  "clientTaxId": "99999999-9",
  "number": "22",
  "createdAt": "2018-04-11 21:02:36",
  "issueDate": "2018-04-11",
  "code": "",
  "type": false,
  "typeName": "Cr\u00e9dito",
  "currency": "CLP",
  "net": "26967.00",
  "taxes": "5124.00",
  "total": "32091.00",
  "gloss": "",
  "notes": "",
  "client": {
    "id": "8201"
  },
  "document": {
    "id": "106221"
  },
  "files": []