Benvenuto su Newo | Documentazione

Introduzione

URL base: https://api.newo.io

This documentation aims to provide all the information you need to work with our API.

<aside>As you scroll, you'll see code examples for working with the API in different programming languages in the dark area to the right (or as part of the content on mobile).
You can switch the language used with the tabs at the top right (or from the nav menu at the top left on mobile).</aside>

Autenticazione delle richieste

Per autenticare le richieste, includi un'intestazione Authorization con valore "Bearer {YOUR_API_TOKEN}".

Tutti gli endpoint che richiedono autenticazione sono contrassegnati con il badge richiede autenticazione nella documentazione sottostante.

Puoi creare e gestire i tuoi token di autenticazione accedendo alla tua area personale su https://app.newo.dev/company.

Ogni richiesta alle API deve includere un'intestazione:

Authorization: Bearer {YOUR_API_TOKEN}

I token sono legati alla tua azienda e permettono di accedere alle relative risorse.

Clienti

Crea un nuovo cliente manualmente.

POST

https://api.newo.dev

/clients/store/manual

requires authentication

Intestazioni

Authorization

Example:

Bearer {YOUR_API_TOKEN}

Content-Type

Example:

application/json

Example:

application/json

Parametri nel corpo

name

string

required

Nome del cliente.

Example:

consequatur

string

Email del cliente.

Example:

[email protected]

phone

string

Telefono.

Example:

consequatur

address

string

Indirizzo.

Example:

consequatur

cap

string

CAP.

Example:

consequatur

city

string

Città.

Example:

consequatur

province

string

Provincia.

Example:

consequatur

country

string

default: IT.

Example:

consequatur

piva

string

Partita IVA.

Example:

consequatur

sdi

string

Codice SDI.

Example:

consequatur

pec

string

PEC.

Example:

consequatur

Auth

Bearer

Headers

Body

{ "name": "consequatur", "email": "[email protected]", "phone": "consequatur", "address": "consequatur", "cap": "consequatur", "city": "consequatur", "province": "consequatur", "country": "consequatur", "piva": "consequatur", "sdi": "consequatur", "pec": "consequatur" }

Risposta ricevuta

Richiesta di esempio:

curl --request POST \
    "https://api.newo.dev/clients/store/manual" \
    --header "Authorization: Bearer {YOUR_API_TOKEN}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"name\": \"consequatur\",
    \"email\": \"[email protected]\",
    \"phone\": \"consequatur\",
    \"address\": \"consequatur\",
    \"cap\": \"consequatur\",
    \"city\": \"consequatur\",
    \"province\": \"consequatur\",
    \"country\": \"consequatur\",
    \"piva\": \"consequatur\",
    \"sdi\": \"consequatur\",
    \"pec\": \"consequatur\"
}"

Risposta di esempio:

{
    "success": true,
    "data": {
        "id": 1,
        "name": "Mario Rossi",
        "email": "[email protected]"
    }
}

Crea un nuovo cliente partendo dalla Partita IVA (lookup automatico).

POST

https://api.newo.dev

/clients/store/automatic

requires authentication

Intestazioni

Authorization

Example:

Bearer {YOUR_API_TOKEN}

Content-Type

Example:

application/json

Example:

application/json

Parametri nel corpo

piva

string

required

Partita IVA valida italiana.

Example:

consequatur

Auth

Bearer

Headers

Body

{ "piva": "consequatur" }

Risposta ricevuta

Richiesta di esempio:

curl --request POST \
    "https://api.newo.dev/clients/store/automatic" \
    --header "Authorization: Bearer {YOUR_API_TOKEN}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"piva\": \"consequatur\"
}"

Risposta di esempio:

{
    "success": true,
    "data": {
        "name": "Azienda SRL",
        "piva": "01234567890",
        "city": "Roma"
    }
}

Fatture

Crea una nuova fattura manuale specificando tutti i dati via API.

POST

https://api.newo.dev

/fatture/nuova/manuale

requires authentication

Intestazioni

Authorization

Example:

Bearer {YOUR_API_TOKEN}

Content-Type

Example:

application/json

Example:

application/json

Parametri nel corpo

cliente

object

name

string

required

Nome del cliente.

Example:

consequatur

piva

string

required

Partita IVA del cliente.

Example:

consequatur

address

string

required

Indirizzo del cliente.

Example:

consequatur

cap

string

required

CAP del cliente.

Example:

consequatur

city

string

required

Città del cliente.

Example:

consequatur

province

string

required

Provincia del cliente.

Example:

consequatur

country

string

default: IT Paese del cliente.

Example:

consequatur

sdi

string

nullable Codice SDI del cliente.

Example:

consequatur

pec

string

nullable PEC del cliente.

Example:

consequatur

string

nullable Email del cliente.

Example:

[email protected]

phone

string

nullable Telefono del cliente.

Example:

consequatur

numerazione

string

required

Nome della numerazione da usare.

Example:

consequatur

issue_date

date

required

Data di emissione fattura (YYYY-MM-DD).

Example:

consequatur

tipo_documento

string

in:TD01,TD01_ACC,TD24,TD25 Tipo di documento.

Example:

consequatur

sconto

number

nullable Sconto globale (importo).

Example:

11613.31890586

intestazione

string

nullable Testo da inserire nelle note di intestazione.

Example:

consequatur

note

string

nullable Note aggiuntive.

Example:

consequatur

metodo_pagamento

string

required

Nome del metodo di pagamento.

Example:

consequatur

paid

number

nullable Importo già incassato (se presente, viene creato un pagamento).

Example:

11613.31890586

articoli

string[]

required

Elenco degli articoli.

nome

string

required

Example:

consequatur

quantita

number

required

validation.min.

Example:

prezzo

number

required

validation.min.

Example:

iva

number

required

validation.min.

Example:

descrizione

string

Example:

consequatur

object

nome

string

required

Nome articolo.

Example:

consequatur

quantita

number

required

Quantità.

Example:

11613.31890586

prezzo

number

required

Prezzo unitario.

Example:

11613.31890586

iva

number

required

Aliquota IVA (%).

Example:

11613.31890586

descrizione

string

nullable Descrizione articolo.

Example:

consequatur

scadenze

string[]

nullable Scadenze di pagamento (se omesso, 30gg da issue_date).

date

string

This field is required when scadenze is present. validation.date.

Example:

2025-07-07T16:01:57

value

number

This field is required when scadenze is present. validation.min.

Example:

type

string

This field is required when scadenze is present.

Must be one of:

percent
amount

Example:

amount

object

invia_sdi

boolean

default:true Se inviare la fattura al SDI.

Example:

false

emails

string[]

nullable Altre email a cui inviare la fattura.

Example:

["[email protected]","[email protected]"]

Auth

Bearer

Headers

Body

{ "cliente": { "name": "consequatur", "piva": "consequatur", "address": "consequatur", "cap": "consequatur", "city": "consequatur", "province": "consequatur", "country": "consequatur", "sdi": "consequatur", "pec": "consequatur", "email": "[email protected]", "phone": "consequatur" }, "numerazione": "consequatur", "issue_date": "consequatur", "tipo_documento": "consequatur", "sconto": 11613.31890586, "intestazione": "consequatur", "note": "consequatur", "metodo_pagamento": "consequatur", "paid": 11613.31890586, "articoli": { "nome": "consequatur", "quantita": 45, "prezzo": 56, "iva": 16, "descrizione": "consequatur", "*": { "nome": "consequatur", "quantita": 11613.31890586, "prezzo": 11613.31890586, "iva": 11613.31890586, "descrizione": "consequatur" } }, "scadenze": { "date": "2025-07-07T16:01:57", "value": 45, "type": "amount", "*": { "date": "consequatur", "value": 11613.31890586, "type": "consequatur" } }, "invia_sdi": false, "emails": [ "[email protected]", "[email protected]" ] }

Risposta ricevuta

Richiesta di esempio:

curl --request POST \
    "https://api.newo.dev/fatture/nuova/manuale" \
    --header "Authorization: Bearer {YOUR_API_TOKEN}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"cliente\": {
        \"name\": \"consequatur\",
        \"piva\": \"consequatur\",
        \"address\": \"consequatur\",
        \"cap\": \"consequatur\",
        \"city\": \"consequatur\",
        \"province\": \"consequatur\",
        \"country\": \"consequatur\",
        \"sdi\": \"consequatur\",
        \"pec\": \"consequatur\",
        \"email\": \"[email protected]\",
        \"phone\": \"consequatur\"
    },
    \"numerazione\": \"consequatur\",
    \"issue_date\": \"consequatur\",
    \"tipo_documento\": \"consequatur\",
    \"sconto\": 11613.31890586,
    \"intestazione\": \"consequatur\",
    \"note\": \"consequatur\",
    \"metodo_pagamento\": \"consequatur\",
    \"paid\": 11613.31890586,
    \"articoli\": [
        \"consequatur\"
    ],
    \"scadenze\": [
        \"consequatur\"
    ],
    \"invia_sdi\": false,
    \"emails\": [
        \"[email protected]\",
        \"[email protected]\"
    ]
}"

Risposta di esempio:

{
    "id": 123,
    "url": "https://fatture.newo.io/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/pdf"
}

Crea una nuova fattura automatica tramite lookup dei dati aziendali da Partita IVA.

POST

https://api.newo.dev

/fatture/nuova/piva

requires authentication

Intestazioni

Authorization

Example:

Bearer {YOUR_API_TOKEN}

Content-Type

Example:

application/json

Example:

application/json

Parametri nel corpo

piva

string

required

Partita IVA (con o senza prefisso "IT").

Example:

03666510791

numerazione

string

nullable Nome della numerazione da usare. Default: Standard.

Example:

Standard

issue_date

date

nullable Data di emissione fattura (YYYY-MM-DD). Default: oggi.

Example:

2025-04-29

tipo_documento

string

in:TD01,TD01_ACC,TD24,TD25 nullable Tipo di documento. Default: TD01.

Example:

TD01

metodo_pagamento

string

nullable Nome del metodo di pagamento. Default: ultimo usato.

Example:

Revolut Pro

sconto

number

nullable Sconto globale (importo in Euro).

Example:

20.5

intestazione

string

nullable Testo di intestazione.

Example:

Intestazione personalizzata

note

string

nullable Note aggiuntive.

Example:

Grazie per averci scelto

invia_sdi

boolean

default:true Se inviare la fattura allo SDI.

Example:

true

emails

string[]

nullable Altre email a cui inviare la fattura.

Example:

["[email protected]","[email protected]"]

articoli

object[]

required

Elenco degli articoli.

nome

string

required

Nome articolo.

Example:

Consulenza informatica

quantita

number

required

Quantità.

Example:

prezzo

number

required

Prezzo unitario.

Example:

150

iva

number

required

Aliquota IVA (%).

Example:

descrizione

string

nullable Descrizione articolo.

Example:

Consulenza Maggio 2025

scadenze

object[]

nullable Scadenze di pagamento (se omesso, 30gg da issue_date).

Auth

Bearer

Headers

Body

{ "piva": "03666510791", "numerazione": "Standard", "issue_date": "2025-04-29", "tipo_documento": "TD01", "metodo_pagamento": "Revolut Pro", "sconto": 20.5, "intestazione": "Intestazione personalizzata", "note": "Grazie per averci scelto", "invia_sdi": true, "emails": [ "[email protected]", "[email protected]" ], "articoli": [ { "nome": "Consulenza informatica", "quantita": 22, "prezzo": 150, "iva": 0, "descrizione": "Consulenza Maggio 2025" } ], "scadenze": [ { "date": "2025-05-30", "value": 50, "type": "percent" } ] }

Risposta ricevuta

Richiesta di esempio:

curl --request POST \
    "https://api.newo.dev/fatture/nuova/piva" \
    --header "Authorization: Bearer {YOUR_API_TOKEN}" \
    --header "Content-Type: application/json" \
    --header "Accept: application/json" \
    --data "{
    \"piva\": \"03666510791\",
    \"numerazione\": \"Standard\",
    \"issue_date\": \"2025-04-29\",
    \"tipo_documento\": \"TD01\",
    \"metodo_pagamento\": \"Revolut Pro\",
    \"sconto\": 20.5,
    \"intestazione\": \"Intestazione personalizzata\",
    \"note\": \"Grazie per averci scelto\",
    \"invia_sdi\": true,
    \"emails\": [
        \"[email protected]\",
        \"[email protected]\"
    ],
    \"articoli\": [
        {
            \"nome\": \"Consulenza informatica\",
            \"quantita\": 22,
            \"prezzo\": 150,
            \"iva\": 0,
            \"descrizione\": \"Consulenza Maggio 2025\"
        }
    ],
    \"scadenze\": [
        {
            \"date\": \"2025-05-30\",
            \"value\": 50,
            \"type\": \"percent\"
        },
        {
            \"date\": \"2025-06-30\",
            \"value\": 50,
            \"type\": \"percent\"
        }
    ]
}"

$client = new \GuzzleHttp\Client();
$url = 'https://api.newo.dev/fatture/nuova/piva';
$response = $client->post(
    $url,
    [
        'headers' => [
            'Authorization' => 'Bearer {YOUR_API_TOKEN}',
            'Content-Type' => 'application/json',
            'Accept' => 'application/json',
        ],
        'json' => \Symfony\Component\VarExporter\Internal\Hydrator::hydrate(
            $o = [
                clone (($p = &\Symfony\Component\VarExporter\Internal\Registry::$prototypes)['stdClass'] ?? \Symfony\Component\VarExporter\Internal\Registry::p('stdClass')),
                clone $p['stdClass'],
                clone $p['stdClass'],
            ],
            null,
            [
                'stdClass' => [
                    'nome' => [
                        'Consulenza informatica',
                    ],
                    'quantita' => [
                        22,
                    ],
                    'prezzo' => [
                        150,
                    ],
                    'iva' => [
                        0,
                    ],
                    'descrizione' => [
                        'Consulenza Maggio 2025',
                    ],
                    'date' => [
                        1 => '2025-05-30',
                        '2025-06-30',
                    ],
                    'value' => [
                        1 => 50,
                        50,
                    ],
                    'type' => [
                        1 => 'percent',
                        'percent',
                    ],
                ],
            ],
            [
                'piva' => '03666510791',
                'numerazione' => 'Standard',
                'issue_date' => '2025-04-29',
                'tipo_documento' => 'TD01',
                'metodo_pagamento' => 'Revolut Pro',
                'sconto' => 20.5,
                'intestazione' => 'Intestazione personalizzata',
                'note' => 'Grazie per averci scelto',
                'invia_sdi' => true,
                'emails' => [
                    '[email protected]',
                    '[email protected]',
                ],
                'articoli' => [
                    $o[0],
                ],
                'scadenze' => [
                    $o[1],
                    $o[2],
                ],
            ],
            []
        ),
    ]
);
$body = $response->getBody();
print_r(json_decode((string) $body));

Risposta di esempio:

{
    "success": true,
    "data": {
        "id": 124,
        "url": "https://fatture.newo.io/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx/pdf"
    }
}