Skip to main content

AddToBatch InvoiceMandate

Endpoint​

  • Método: POST
  • Ruta: /api/ubl2.1/add-to-batch/invoice-mandate/{batch_id}
  • URL ejemplo: {{BASE_URL}}/api/ubl2.1/add-to-batch/invoice-mandate/batch1

Descripción​

Agrega una Factura por mandato al lote (batch) indicado en la URL. Luego podrás enviarlo con SendBatch.

Flujo recomendado:

  1. Llama este endpoint por cada documento que quieras agregar al lote.
  2. Cuando completes el lote, ejecuta SendBatch.

Parámetros en la URL​

  • batch_id: identificador del lote. Ejemplo: batch1.

Autenticación​

  • Tipo: Bearer Token
  • Header: Authorization: Bearer {{API_TOKEN}}

Headers​

KeyValue
AuthorizationBearer {{API_TOKEN}}
Content-Typeapplication/json
Acceptapplication/json

Body​

{
  "number": 990000465,
  "dv": 2,
  "type_document_id": 1,
  "date": "2020-01-03",
  "time": "06:44:45",
  "resolution_number": "18760000001",
  "prefix": "SETP",
  "establishment_name": "TORRE SOFTWARE",
  "notes": "SIN OBSERVACIONES",
  "customer": {
    "identification_number": 89008003,
    "dv": 2,
    "name": "ALEXANDER OBANDO LONDONO",
    "phone": 3103891693,
    "address": "BRR LIMONAR MZ 6 CS 3 ET 1",
    "email": "alexander_obando@hotmail.com",
    "merchant_registration": "0000-00",
    "type_document_identification_id": 6,
    "type_organization_id": 2,
    "municipality_id": 149,
    "type_regime_id": 2
  },
  "payment_form": {
    "payment_form_id": 1,
    "payment_method_id": 10,
    "payment_due_date": "2020-01-03",
    "duration_measure": "0"
  },
  "allowance_charges": [
    {
      "discount_id": 1,
      "charge_indicator": false,
      "allowance_charge_reason": "DESCUENTO GENERAL",
      "amount": "0.00",
      "base_amount": "1704201.68"
    }
  ],
  "legal_monetary_totals": {
    "line_extension_amount": "1704201.68",
    "tax_exclusive_amount": "1704201.68",
    "tax_inclusive_amount": "1800000.00",
    "allowance_total_amount": "0.00",
    "charge_total_amount": "0.00",
    "payable_amount": "1800000.00"
  },
  "tax_totals": [
    {
      "tax_id": 1,
      "tax_amount": "0.00",
      "percent": "0",
      "taxable_amount": "1200000.00"
    },
    {
      "tax_id": 1,
      "tax_amount": "95798.32",
      "percent": "19",
      "taxable_amount": "504201.68"
    }
  ],
  "invoice_lines": [
    {
      "unit_measure_id": 70,
      "invoiced_quantity": "1",
      "line_extension_amount": "600000.00",
      "free_of_charge_indicator": false,
      "allowance_charges": [
        {
          "charge_indicator": false,
          "allowance_charge_reason": "DESCUENTO GENERAL",
          "amount": "0.00",
          "base_amount": "600000.00"
        }
      ],
      "tax_totals": [
        {
          "tax_id": 1,
          "tax_amount": "0.00",
          "taxable_amount": "600000.00",
          "percent": "0.00"
        }
      ],
      "description": "PRUEBA MANDATO",
      "code": "PRUEBA1",
      "type_item_identification_id": 4,
      "price_amount": "600000.00",
      "base_quantity": "1"
    },
    {
      "unit_measure_id": 70,
      "invoiced_quantity": "1",
      "line_extension_amount": "600000.00",
      "free_of_charge_indicator": false,
      "allowance_charges": [
        {
          "charge_indicator": false,
          "allowance_charge_reason": "DESCUENTO GENERAL",
          "amount": "0.00",
          "base_amount": "600000.00"
        }
      ],
      "tax_totals": [
        {
          "tax_id": 1,
          "tax_amount": "0.00",
          "taxable_amount": "600000.00",
          "percent": "0.00"
        }
      ],
      "description": "PRUEBA MANDATO",
      "code": "PRUEBA2",
      "type_item_identification_id": 4,
      "price_amount": "600000.00",
      "base_quantity": "1"
    },
    {
      "unit_measure_id": 70,
      "invoiced_quantity": "1",
      "line_extension_amount": "504201.68",
      "free_of_charge_indicator": false,
      "allowance_charges": [
        {
          "charge_indicator": false,
          "allowance_charge_reason": "DESCUENTO GENERAL",
          "amount": "0.00",
          "base_amount": "600000.00"
        }
      ],
      "tax_totals": [
        {
          "tax_id": 1,
          "tax_amount": "95798.32",
          "taxable_amount": "504201.68",
          "percent": "19.00"
        }
      ],
      "description": "PRUEBA MANDATO",
      "agentparty": 900468658,
      "agentparty_dv": 1,
      "code": "PRUEBA3",
      "type_item_identification_id": 4,
      "price_amount": "504201.68",
      "base_quantity": "1"
    }
  ]
}

Ejemplo cURL​

curl -X POST '{{BASE_URL}}/api/ubl2.1/add-to-batch/invoice-mandate/batch1' \
  -H 'Authorization: Bearer {{API_TOKEN}}' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json' \
  --data-raw '{
  "number": 990000465,
  "dv": 2,
  "type_document_id": 1,
  "date": "2020-01-03",
  "time": "06:44:45",
  "resolution_number": "18760000001",
  "prefix": "SETP",
  "establishment_name": "TORRE SOFTWARE",
  "notes": "SIN OBSERVACIONES",
  "customer": {
    "identification_number": 89008003,
    "dv": 2,
    "name": "ALEXANDER OBANDO LONDONO",
    "phone": 3103891693,
    "address": "BRR LIMONAR MZ 6 CS 3 ET 1",
    "email": "alexander_obando@hotmail.com",
    "merchant_registration": "0000-00",
    "type_document_identification_id": 6,
    "type_organization_id": 2,
    "municipality_id": 149,
    "type_regime_id": 2
  },
  "payment_form": {
    "payment_form_id": 1,
    "payment_method_id": 10,
    "payment_due_date": "2020-01-03",
    "duration_measure": "0"
  },
  "allowance_charges": [
    {
      "discount_id": 1,
      "charge_indicator": false,
      "allowance_charge_reason": "DESCUENTO GENERAL",
      "amount": "0.00",
      "base_amount": "1704201.68"
    }
  ],
  "legal_monetary_totals": {
    "line_extension_amount": "1704201.68",
    "tax_exclusive_amount": "1704201.68",
    "tax_inclusive_amount": "1800000.00",
    "allowance_total_amount": "0.00",
    "charge_total_amount": "0.00",
    "payable_amount": "1800000.00"
  },
  "tax_totals": [
    {
      "tax_id": 1,
      "tax_amount": "0.00",
      "percent": "0",
      "taxable_amount": "1200000.00"
    },
    {
      "tax_id": 1,
      "tax_amount": "95798.32",
      "percent": "19",
      "taxable_amount": "504201.68"
    }
  ],
  "invoice_lines": [
    {
      "unit_measure_id": 70,
      "invoiced_quantity": "1",
      "line_extension_amount": "600000.00",
      "free_of_charge_indicator": false,
      "allowance_charges": [
        {
          "charge_indicator": false,
          "allowance_charge_reason": "DESCUENTO GENERAL",
          "amount": "0.00",
          "base_amount": "600000.00"
        }
      ],
      "tax_totals": [
        {
          "tax_id": 1,
          "tax_amount": "0.00",
          "taxable_amount": "600000.00",
          "percent": "0.00"
        }
      ],
      "description": "PRUEBA MANDATO",
      "code": "PRUEBA1",
      "type_item_identification_id": 4,
      "price_amount": "600000.00",
      "base_quantity": "1"
    },
    {
      "unit_measure_id": 70,
      "invoiced_quantity": "1",
      "line_extension_amount": "600000.00",
      "free_of_charge_indicator": false,
      "allowance_charges": [
        {
          "charge_indicator": false,
          "allowance_charge_reason": "DESCUENTO GENERAL",
          "amount": "0.00",
          "base_amount": "600000.00"
        }
      ],
      "tax_totals": [
        {
          "tax_id": 1,
          "tax_amount": "0.00",
          "taxable_amount": "600000.00",
          "percent": "0.00"
        }
      ],
      "description": "PRUEBA MANDATO",
      "code": "PRUEBA2",
      "type_item_identification_id": 4,
      "price_amount": "600000.00",
      "base_quantity": "1"
    },
    {
      "unit_measure_id": 70,
      "invoiced_quantity": "1",
      "line_extension_amount": "504201.68",
      "free_of_charge_indicator": false,
      "allowance_charges": [
        {
          "charge_indicator": false,
          "allowance_charge_reason": "DESCUENTO GENERAL",
          "amount": "0.00",
          "base_amount": "600000.00"
        }
      ],
      "tax_totals": [
        {
          "tax_id": 1,
          "tax_amount": "95798.32",
          "taxable_amount": "504201.68",
          "percent": "19.00"
        }
      ],
      "description": "PRUEBA MANDATO",
      "agentparty": 900468658,
      "agentparty_dv": 1,
      "code": "PRUEBA3",
      "type_item_identification_id": 4,
      "price_amount": "504201.68",
      "base_quantity": "1"
    }
  ]
}'

Probar endpoint

POST
AddToBatch InvoiceMandate
BASE URL
Se guarda localmente en tu navegador.
BEARER TOKEN
Se guarda solo en esta sesión/pestaña.
PATH PARAMS
batch_id
URL FINAL
/api/ubl2.1/add-to-batch/invoice-mandate/batch1
BODY JSON
RESPUESTA
Envía la solicitud para ver la respuesta aquí.