ALalegra
Notas Crédito electrónicas

Endpoint para emitir una nota crédito electrónica a la DIAN

Changed on

Este endpoint permite emitir una nota crédito electrónica a la DIAN.

Recuerda visitar previamente las guías de Inicio y la guía de Habilitación en la DIAN - Factura Electronica

post/credit-notes

Request

  • Base URL
    https://sandbox-api.alegra.com/e-provider/col/v1
  • URL
    https://sandbox-api.alegra.com/e-provider/col/v1/credit-notes
  • Auth
    HTTP bearer

Parameters

#/paths/~1events/post/parameters/0 (unresolved $ref)

Request body

documentType'91' | '91-22' | '02'

Tipo de Nota de Crédito. 91: Estándar, 91-22: Estándar sin referencia a Factura, 02: Exportación. Este atributo es opcional, sino se envia este valor, Alegra asociará esta Nota Crédito como una Nota Crédito de Venta Estándar

prefixstring

Prefijo de la nota crédito electrónica

numbernumber double required

Número de la nota crédito electrónica

conceptCodestring required

Concepto por el cual se genera la nota crédito. Este elemento acepta una de las siguientes opciones: 1 Devolución parcial de los bienes y/o no aceptación parcial del servicio; 2 Anulación de factura electrónica; 3 Rebaja o descuento parcial o total; 4 Ajuste de precio; 5 Descuento comercial por pronto pago; 6 Descuento comercial por volumen de ventas.<br><i>Campo oficial DIAN <ResponseCode></i>

notestring[]

Notas o información adicional: Texto libre, relativo al documento. Máximo 5000 caracteres por nota. <br><i>Campo oficial DIAN <Note></i>

associatedDocumentsItems[] (unresolved $ref)

Array que contiene la información de la factura electrónica afectada por la Nota. Solamente puede reportar 1 factura electrónica y debe ser de un mismo adquiriente. Obligatorio si el tipo de documento es Estandar o Exportación.

companyCompany required(unresolved $ref)
customerCustomer required(unresolved $ref)
itemsItems[] required(unresolved $ref)

Array que contiene el listado de artículos y/o servicios

paymentsPayments required(unresolved $ref)
discountsAndChargesDiscountsAndCharges (unresolved $ref)
invoicePeriodInvoicePeriod (unresolved $ref)
orderReferenceOrderReference (unresolved $ref)
despatchDocumentReferencesDespatchDocumentReferences (unresolved $ref)
receiptDocumentReferencesReceiptDocumentReferences (unresolved $ref)
dueDiligenceCodeDueDiligenceCode (unresolved $ref)
foreignCurrencyForeignCurrency (unresolved $ref)

Response

Objeto que representa la respuesta cuando se envía una nota crédito electrónica a la DIAN

Changes

  • 2bc52ab55c2bRevision changes
    • warning

      the / request property's exclusiveMinimum was set to true

    • warning

      the / request property's maxLength was set to 5000

    • warning

      removed the optional property from the response with the status

    • warning

      removed the optional property from the response with the status

    • info

      added the new optional header request parameter Idempotency-Key

    • info

      added the new optional request property

    • info

      added the new optional request property /

    • info

      added the new optional request property //

    • info

      added the new optional request property //

    • info

      added the new optional request property

    • info

      the /// request property format was generalized from float to no format

    • info

      the / request property format was generalized from float to no format

    • info

      the / request property format was generalized from float to no format

    • info

      the / request property format was generalized from float to no format

    • info

      the / request property format was generalized from float to no format

    • info

      the / request property format was generalized from float to no format

    • info

      the / request property format was generalized from float to no format

    • info

      the / request property format was generalized from float to no format

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the optional property to the response with the status

    • info

      added the optional property to the response with the status