Skip to main content

Health SS-cufe | Capita Periodo

Descripción​

ENVIO DE FACTURA SECTOR SALUD TIPO CAPITA PERIODO

  • contiene atencion de pacientes

  • se utiliza tipo SS-CUFE

  • el JSON y el XML son similares a los ejemplos de la factura de Salud

  • el attacheddocument debe usarse en el rips como en el ejemplo RIPS Capita Periodo

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

{
    "number": 990070006,
    "type_document_id": 1,
    "date": "2025-06-16",
    "time": "09:09:12",
    "resolution_number": "18760000001",
    "prefix": "SETP",
    "disable_confirmation_text": true,
    "establishment_name": "TORRE SOFTWARE",
    "establishment_address": "BRR LIMONAR MZ 6 CS 3 ET 1 PISO 2",
    "establishment_phone": "3226563672",
    "establishment_municipality": 600,
    "establishment_email": "alternate_email@alternate.com",
    "sendmail": false,
    "sendmailtome": false,
    "send_customer_credentials": false,
    "seze": "2021-2017",
    "email_cc_list": [],
    "customer": {
        "identification_number": 900166483,
        "dv": 1,
        "name": "INVERSIONES DAVAL SAS",
        "phone": "3103891693",
        "address": "CLL 4 NRO 33-90",
        "email": "alexanderobandolondonos@gmail.com",
        "merchant_registration": "0000000-00",
        "type_document_identification_id": 6,
        "type_organization_id": 1,
        "type_liability_id": 7,
        "municipality_id": 822,
        "type_regime_id": 1
    },
    "payment_form": {
        "payment_form_id": 1,
        "payment_method_id": 10,
        "payment_due_date": "2025-06-13",
        "duration_measure": "0"
    },
    "legal_monetary_totals": {
        "line_extension_amount": "840336.134",
        "tax_exclusive_amount": "840336.134",
        "tax_inclusive_amount": "1000000.00",
        "payable_amount": "1000000.00"
    },
    "tax_totals": [
        {
            "tax_id": 1,
            "tax_amount": "159663.865",
            "percent": "19.00",
            "taxable_amount": "840336.134"
        }
    ],
    "invoice_lines": [
        {
            "unit_measure_id": 70,
            "invoiced_quantity": "1",
            "line_extension_amount": "840336.134",
            "free_of_charge_indicator": false,
            "tax_totals": [
                {
                    "tax_id": 1,
                    "tax_amount": "159663.865",
                    "taxable_amount": "840336.134",
                    "percent": "19.00"
                }
            ],
            "description": "RECAUDO PERIODO",
            "notes": "RECAUDO PERIODO POR PERIODO DE CAPITACIÓN MAYO 2025",
            "code": "RECAUDO",
            "type_item_identification_id": 4,
            "price_amount": "1000000.00",
            "base_quantity": "1"
        }
    ],
    "health_fields": {
        "invoice_period_start_date": "2025-05-01",
        "invoice_period_end_date": "2025-05-31",
        "health_type_operation_id": 1,
        "print_users_info_to_pdf": true,
        "users_info": [
            {
                "provider_code": "900123456",
                "health_type_document_identification_id": 1,
                "identification_number": "11223344",
                "surname": "Apellido1",
                "second_surname": "Apellido2",
                "first_name": "Nombre1",
                "middle_name": "Nombre2",
                "health_type_user_id": 4,
                "health_contracting_payment_method_id": 4,
                "health_coverage_id": 10,
                "co_payment": 5000,
                "moderating_fee": "0",
                "recovery_fee": 0,
                "shared_payment": 0
            },
            {
                "provider_code": "900123457",
                "health_type_document_identification_id": 1,
                "identification_number": "55667788",
                "surname": "Apellido3",
                "second_surname": "Apellido4",
                "first_name": "Nombre3",
                "middle_name": "Nombre4",
                "health_type_user_id": 4,
                "health_contracting_payment_method_id": 4,
                "health_coverage_id": 10,
                "co_payment": 0,
                "moderating_fee": "4000",
                "recovery_fee": 0,
                "shared_payment": 0
            },
            {
                "provider_code": "900123458",
                "health_type_document_identification_id": 1,
                "identification_number": "99887766",
                "surname": "Apellido5",
                "second_surname": "Apellido6",
                "first_name": "Nombre5",
                "middle_name": "Nombre6",
                "health_type_user_id": 4,
                "health_contracting_payment_method_id": 4,
                "health_coverage_id": 10,
                "co_payment": 0,
                "moderating_fee": "0",
                "recovery_fee": 0,
                "shared_payment": 0
            }
        ]
    }
}

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" \
--header "Content-Type: application/json" \
--data '{
    "number": 990070006,
    "type_document_id": 1,
    "date": "2025-06-16",
    "time": "09:09:12",
    "resolution_number": "18760000001",
    "prefix": "SETP",
    "disable_confirmation_text": true,
    "establishment_name": "TORRE SOFTWARE",
    "establishment_address": "BRR LIMONAR MZ 6 CS 3 ET 1 PISO 2",
    "establishment_phone": "3226563672",
    "establishment_municipality": 600,
    "establishment_email": "alternate_email@alternate.com",
    "sendmail": false,
    "sendmailtome": false,
    "send_customer_credentials": false,
    "seze": "2021-2017",
    "email_cc_list": [],
    "customer": {
        "identification_number": 900166483,
        "dv": 1,
        "name": "INVERSIONES DAVAL SAS",
        "phone": "3103891693",
        "address": "CLL 4 NRO 33-90",
        "email": "alexanderobandolondonos@gmail.com",
        "merchant_registration": "0000000-00",
        "type_document_identification_id": 6,
        "type_organization_id": 1,
        "type_liability_id": 7,
        "municipality_id": 822,
        "type_regime_id": 1
    },
    "payment_form": {
        "payment_form_id": 1,
        "payment_method_id": 10,
        "payment_due_date": "2025-06-13",
        "duration_measure": "0"
    },
    "legal_monetary_totals": {
        "line_extension_amount": "840336.134",
        "tax_exclusive_amount": "840336.134",
        "tax_inclusive_amount": "1000000.00",
        "payable_amount": "1000000.00"
    },
    "tax_totals": [
        {
            "tax_id": 1,
            "tax_amount": "159663.865",
            "percent": "19.00",
            "taxable_amount": "840336.134"
        }
    ],
    "invoice_lines": [
        {
            "unit_measure_id": 70,
            "invoiced_quantity": "1",
            "line_extension_amount": "840336.134",
            "free_of_charge_indicator": false,
            "tax_totals": [
                {
                    "tax_id": 1,
                    "tax_amount": "159663.865",
                    "taxable_amount": "840336.134",
                    "percent": "19.00"
                }
            ],
            "description": "RECAUDO PERIODO",
            "notes": "RECAUDO PERIODO POR PERIODO DE CAPITACIÓN MAYO 2025",
            "code": "RECAUDO",
            "type_item_identification_id": 4,
            "price_amount": "1000000.00",
            "base_quantity": "1"
        }
    ],
    "health_fields": {
        "invoice_period_start_date": "2025-05-01",
        "invoice_period_end_date": "2025-05-31",
        "health_type_operation_id": 1,
        "print_users_info_to_pdf": true,
        "users_info": [
            {
                "provider_code": "900123456",
                "health_type_document_identification_id": 1,
                "identification_number": "11223344",
                "surname": "Apellido1",
                "second_surname": "Apellido2",
                "first_name": "Nombre1",
                "middle_name": "Nombre2",
                "health_type_user_id": 4,
                "health_contracting_payment_method_id": 4,
                "health_coverage_id": 10,
                "co_payment": 5000,
                "moderating_fee": "0",
                "recovery_fee": 0,
                "shared_payment": 0
            },
            {
                "provider_code": "900123457",
                "health_type_document_identification_id": 1,
                "identification_number": "55667788",
                "surname": "Apellido3",
                "second_surname": "Apellido4",
                "first_name": "Nombre3",
                "middle_name": "Nombre4",
                "health_type_user_id": 4,
                "health_contracting_payment_method_id": 4,
                "health_coverage_id": 10,
                "co_payment": 0,
                "moderating_fee": "4000",
                "recovery_fee": 0,
                "shared_payment": 0
            },
            {
                "provider_code": "900123458",
                "health_type_document_identification_id": 1,
                "identification_number": "99887766",
                "surname": "Apellido5",
                "second_surname": "Apellido6",
                "first_name": "Nombre5",
                "middle_name": "Nombre6",
                "health_type_user_id": 4,
                "health_contracting_payment_method_id": 4,
                "health_coverage_id": 10,
                "co_payment": 0,
                "moderating_fee": "0",
                "recovery_fee": 0,
                "shared_payment": 0
            }
        ]
    }
}'

Probar endpoint

POST
Health SS-cufe | Capita Periodo
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í.