Skip to main content

Health SS | Contrato sin factura

Descripción​

ENVIO DE FACTURA SECTOR SALUD - CONTRATO SIN FACTURA​

  • Aplica la misma documentacion que el PRIMER ENVIO DE FACTURA de la seccion 02 - PRIMEROS ENVIOS.

  • Este ejemplo ilustra como se debe utilizar la API para enviar una factura para EL SECTOR SALUD, se utiliza para este fin el grupo de campos health_fields.

  • En este caso, dentro de cada paciente (health_fields.users_info) se utiliza el campo health_invoice_without_contract_id (id contrato sin factura).

Endpoint​

  • Método: POST
  • URL: {{BASE_URL}}/api/ubl2.1/invoice

Autenticación​

Bearer {{API_TOKEN}}

Headers​

HeaderValor
Content-Typeapplication/json
Acceptapplication/json

Body​

Tipo: json

{
  "type_document_id": 1,
  "prefix": "SETP",
  "number": 994900176,
  "resolution_number": "18760000001",
  "date": "2026-06-11",
  "time": "09:51:05",
  "type_operation_id": 10,
  "notes": "SERVICIO MÉDICO PRESTADO - FACTURA SECTOR SALUD",
  "document_currency_code": "COP",

  "seller": {
    "identification_number": "900368327",
    "dv": "8",
    "name": "MEDICAL HOMECARE S.A.S.",
    "phone": "6015840999",
    "address": "CL 16 B 9 49",
    "email": "medicalhomecaresas@gmail.com",
    "type_document_identification_id": 8,
    "type_organization_id": 1,
    "type_regime_id": 2,
    "type_liability_id": 7,
    "municipality_id": 404,
    "merchant_registration": "Régimen Común"
  },

  "customer": {
    "identification_number": "824001398",
    "dv": "1",
    "name": "ASOCIACION DE CABILDOS INDIGENAS DEL CESAR Y LA GUAJIRA - DUSAKAWI EPSI",
    "phone": "5700373",
    "address": "Calle 8 No 17 – 17 Barrio Pontevedra",
    "email": "facturacionelectronica@dusakawiepsi.com",
    "type_document_identification_id": 6,
    "type_organization_id": 1,
    "type_regime_id": 2,
    "type_liability_id": 7,
    "municipality_id": 404
  },

  "payment_form": {
    "payment_form_id": 1,
    "payment_method_id": 10,
    "payment_due_date": "2026-04-01",
    "duration_measure": 30
  },

  "tax_totals": [
    {
      "tax_id": 1,
      "tax_amount": 0,
      "taxable_amount": "21390000.00",
      "percent": 0
    }
  ],

  "legal_monetary_totals": {
    "line_extension_amount": "21390000.00",
    "tax_exclusive_amount": "21390000.00",
    "tax_inclusive_amount": "21390000.00",
    "allowance_total_amount": 0,
    "charge_total_amount": 0,
    "payable_amount": "21390000.00"
  },

  "invoice_lines": [
    {
      "unit_measure_id": 94,
      "invoiced_quantity": "1.000000",
      "line_extension_amount": "21390000.00",
      "free_of_charge_indicator": false,
      "description": "INTERNACION DE PACIENTE CRONICO TERMINAL CON VENTILADOR COMPLEJIDAD MEDIANA",
      "code": "133M01",
      "type_item_identification_id": 4,
      "price_amount": "21390000.00",
      "base_quantity": "1.000000",
      "tax_totals": [
        {
          "tax_id": 1,
          "tax_amount": 0,
          "taxable_amount": "21390000.00",
          "percent": 0
        }
      ]
    }
  ],

  "health_fields": {
    "invoice_period_start_date": "2026-03-03",
    "invoice_period_end_date": "2026-03-03",
    "health_type_operation_id": 7,
    "health_contracting_payment_method_id": 1,
    "print_users_info_to_pdf": true,
    "users_info": [
        {
        "provider_code": "AF-00000002",
        "identification_number": "1065684560",
        "first_name": "JOSE",
        "surname": "",
        "health_contracting_payment_method_id": 4,
        "health_coverage_id": 6,
        "contract_number": "",
        "health_invoice_without_contract_id": 1, //id contrato sin factura
        "co_payment": 0,
        "moderating_fee": 0,
        "recovery_fee": 0,
        "shared_payment": 0,
        "advance_payment": 0
        }
    ]
  },

  "additional_fields": {
    "responsable": "url www.minsalud.gov.co",
    "tipo_identificador_ano_acto": "Resolución 506:2021"
  }
}

Ejemplo cURL​

curl --request POST \
--url "{{BASE_URL}}/api/ubl2.1/invoice" \
--header "Authorization: Bearer {{API_TOKEN}}" \
--header "Content-Type: application/json" \
--header "Accept: application/json" \
--data '{
  "type_document_id": 1,
  "prefix": "SETP",
  "number": 994900176,
  "resolution_number": "18760000001",
  "date": "2026-06-11",
  "time": "09:51:05",
  "type_operation_id": 10,
  "notes": "SERVICIO MÉDICO PRESTADO - FACTURA SECTOR SALUD",
  "document_currency_code": "COP",
  "seller": {
    "identification_number": "900368327",
    "dv": "8",
    "name": "MEDICAL HOMECARE S.A.S.",
    "phone": "6015840999",
    "address": "CL 16 B 9 49",
    "email": "medicalhomecaresas@gmail.com",
    "type_document_identification_id": 8,
    "type_organization_id": 1,
    "type_regime_id": 2,
    "type_liability_id": 7,
    "municipality_id": 404,
    "merchant_registration": "Régimen Común"
  },
  "customer": {
    "identification_number": "824001398",
    "dv": "1",
    "name": "ASOCIACION DE CABILDOS INDIGENAS DEL CESAR Y LA GUAJIRA - DUSAKAWI EPSI",
    "phone": "5700373",
    "address": "Calle 8 No 17 – 17 Barrio Pontevedra",
    "email": "facturacionelectronica@dusakawiepsi.com",
    "type_document_identification_id": 6,
    "type_organization_id": 1,
    "type_regime_id": 2,
    "type_liability_id": 7,
    "municipality_id": 404
  },
  "payment_form": {
    "payment_form_id": 1,
    "payment_method_id": 10,
    "payment_due_date": "2026-04-01",
    "duration_measure": 30
  },
  "tax_totals": [
    {
      "tax_id": 1,
      "tax_amount": 0,
      "taxable_amount": "21390000.00",
      "percent": 0
    }
  ],
  "legal_monetary_totals": {
    "line_extension_amount": "21390000.00",
    "tax_exclusive_amount": "21390000.00",
    "tax_inclusive_amount": "21390000.00",
    "allowance_total_amount": 0,
    "charge_total_amount": 0,
    "payable_amount": "21390000.00"
  },
  "invoice_lines": [
    {
      "unit_measure_id": 94,
      "invoiced_quantity": "1.000000",
      "line_extension_amount": "21390000.00",
      "free_of_charge_indicator": false,
      "description": "INTERNACION DE PACIENTE CRONICO TERMINAL CON VENTILADOR COMPLEJIDAD MEDIANA",
      "code": "133M01",
      "type_item_identification_id": 4,
      "price_amount": "21390000.00",
      "base_quantity": "1.000000",
      "tax_totals": [
        {
          "tax_id": 1,
          "tax_amount": 0,
          "taxable_amount": "21390000.00",
          "percent": 0
        }
      ]
    }
  ],
  "health_fields": {
    "invoice_period_start_date": "2026-03-03",
    "invoice_period_end_date": "2026-03-03",
    "health_type_operation_id": 7,
    "health_contracting_payment_method_id": 1,
    "print_users_info_to_pdf": true,
    "users_info": [
        {
        "provider_code": "AF-00000002",
        "identification_number": "1065684560",
        "first_name": "JOSE",
        "surname": "",
        "health_contracting_payment_method_id": 4,
        "health_coverage_id": 6,
        "contract_number": "",
        "health_invoice_without_contract_id": 1,
        "co_payment": 0,
        "moderating_fee": 0,
        "recovery_fee": 0,
        "shared_payment": 0,
        "advance_payment": 0
        }
    ]
  },
  "additional_fields": {
    "responsable": "url www.minsalud.gov.co",
    "tipo_identificador_ano_acto": "Resolución 506:2021"
  }
}'

Probar endpoint

POST
Health SS | Contrato sin factura
BASE URL
Se guarda localmente en tu navegador.
BEARER TOKEN
Se guarda solo en esta sesión/pestaña.
URL FINAL
/api/ubl2.1/invoice
BODY JSON
RESPUESTA
Envía la solicitud para ver la respuesta aquí.